マイクロアプリ

Cherwellの統合

Cherwell統合テンプレートを展開して、インシデントとサービス要求を管理し、変更に関する通知が行われるようにします。

ご意見、ご要望をお聞かせください。この統合テンプレートに関するフィードバックをお送りください。また、問題についてはサポートチームが専用のフォーラムを毎日確認いたします。

すぐに利用可能なCherwell用のマイクロアプリの包括的な詳細については、「Cherwellマイクロアプリの使用」を参照してください。

必須条件の確認

Cherwellでこの統合をセットアップした後、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • ベースURLhttps:/{Cherwell_Instance_URL}/CherwellAPI/api/{Cherwell_Instance_URL}は、Cherwellを購入した際に取得しています。
  • トークンURLhttps:/{Cherwell_Instance_URL}/CherwellAPI/token{Cherwell_Instance_URL}は、Cherwellを購入した際に取得しています。
  • ユーザー名:ユーザー名とパスワードは、Cherwellにアクセスできるサービスアカウントの資格情報です。
  • パスワード:ユーザー名とパスワードは、Cherwellにアクセスできるサービスアカウントの資格情報です。
  • クライアントID:クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。
  • クライアントシークレット:クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。

利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。

統合ではCherwellインスタンスへの定期的なアクセスが必要なので、Cherwellで専用のユーザーアカウントを作成することをお勧めします。このアカウントには、次の権限が必要です:

  • 管理者セキュリティグループ

クライアントIDとクライアントシークレットの作成

この手順を実行する前に、https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/に移動して、Cherwell Service Managementをダウンロードおよびインストールします。

  1. ユーザーIDとパスワードを使用してログインします。
  2. Cherwell Service Managementアプリの画面で、[Security]を選択します。
  3. [Edit REST API client settings] に移動します。
  4. [Create a new client] を選択します。
  5. 次の値を入力します:

    • 名前
    • 説明
    • [Token lifespan] に「360」を入力します。
    • *[Refresh Token lifespan]に「1440*」を入力します。
    • [API Access enabled] チェックボックスを選択します。
  6. [Save current client] を選択します。
  7. クライアントキーをコピーして保存します。これは、統合を構成するときに、サービス認証のクライアントIDクライアントシークレットの値になります。

ユーザー名とパスワードの作成

この手順を実行する前に、https://{ Cherwell_Instance_URL}/CherwellAutoDeploy/に移動して、Cherwell Service Managementをダウンロードおよびインストールします。

  1. ユーザーIDとパスワードを使用してログインします。
  2. Cherwell Service Managementアプリの画面で、[Security]を選択します。
  3. [Edit Users] を選択します。
  4. [Create new user] を選択します。
  5. 次の値を入力します:

    • ログインID
    • パスワード
    • パスワードの確認入力
  6. [Security Group: Admin]を選択し、フルネームメールアドレスを入力します。
  7. [Password never expires] チェックボックスを選択します。
  8. [Save current user] を選択します。

注:

Citrix Workspaceマイクロアプリへの統合の追加

Cherwell統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. [マイクロアプリ統合] ページで [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  2. Cherwellタイルを選択します。
  3. 統合の名前を入力します。
  4. コネクタのパラメーターを入力します。
    • インスタンスの [ベースURL] を入力します:https:/{Cherwell_Instance_URL}/CherwellAPI/api/{Cherwell_Instance_URL}は、Cherwellを購入した際に取得しています。
    • アイコンライブラリから統合のアイコンを選択するか、デフォルトのアイコンのままにしておきます。
  5. [サービス認証][認証方法] メニューから [OAuth 2.0] を選択して認証の詳細を完了します。認証オプションは事前に選択されています。プロセスの完了時に、これらのオプションが選択されていることを確認してください。OAuth 2.0セキュリティプロトコルを使用して、委任されたアクセスの要求/承認トークンを生成します。利用可能な場合は、サービス認証方法として常にOAuth 2.0を使用することをお勧めします。OAuth 2.0は、統合が、構成済みのマイクロアプリとの最大限のセキュリティコンプライアンスを満たすことを保証します。
    1. [許可の種類] メニューから [リソース所有者のパスワード] を選択します。
    2. [許可の種類の値]パスワードを入力します。
    3. [トークン認証][要求の本文] を選択します。
    4. [トークンコンテンツの種類][URLエンコード形式] を選択します。
    5. [トークンURL] を入力します:https:/{Cherwell_Instance_URL}/CherwellAPI/token{Cherwell_Instance_URL}は、Cherwellを購入した際に取得しています。
    6. [ユーザー名] を入力します。ユーザー名とパスワードは、Cherwellにアクセスできるサービスアカウントの資格情報です。
    7. [パスワード] を入力します。ユーザー名とパスワードは、Cherwellにアクセスできるサービスアカウントの資格情報です。
    8. [クライアントID] を入力します。クライアントIDは、承認サーバーに固有のクライアント登録情報を表す文字列です。
    9. [クライアントシークレット] を入力します。クライアントシークレットは、ターゲットアプリケーション統合のセットアップ時に発行される一意の文字列です。
    10. [ヘッダープレフィックス] メニューから [ベアラー] を選択します。
    11. [アクセストークンパラメーター] で、[名前]に「auth_mode」、[値]に「internal」を入力します。
  6. [サービスアクション認証] トグルは無効のままにします。
  7. [要求レート制限を有効にする] トグルは無効のままにします。
  8. (オプション)サポートのために24時間のログを保持するには、[ログ]を有効にします。
  9. [保存] を選択して続行します。

これで、最初のデータ同期を設定して実行する準備ができました。同期ルール、スケジュールを満たさない同期、および拒否ルールについて詳しくは、「データの同期」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Cherwellコネクタの仕様」を参照してください。

Cherwellマイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

インシデントの作成: ユーザーはインシデントを作成できます。

通知またはページ ユースケースワークフロー
インシデントの作成ページ インシデントを作成するフォームが表示されます。

サービス要求の作成: カタログから新しいサービス要求を作成するか、または事前定義されたサービス要求テンプレートを選択します。

通知またはページ ユースケースワークフロー
サービス要求の作成ページ 事前定義されたテンプレートを選択、またはサービスカタログから要求を作成するためのフォームが表示されます。

自分のオープンインシデント: ワークスペースユーザーは所有するオープンインシデントを表示および管理できます。

通知またはページ ユースケースワークフロー
インシデント作成通知 新しいインシデントが作成されると、インシデントの所有者は通知を受け取ります。
インシデント解決SLAしきい値ヒット通知 インシデントの解決SLAが達成されなかった場合、インシデントの所有者は通知を受け取ります。
インシデント応答SLAしきい値ヒット通知 インシデントの応答SLAが達成されなかった場合、インシデントの所有者は通知を受け取ります。
インシデントステータス変更通知 インシデントのステータスが変更されると、インシデントの所有者は通知を受け取ります。
自分のオープンインシデントページ ワークスペースユーザーが所有するオープンインシデントのリストが表示されます。
インシデントの詳細ページ コメントの追加およびインシデントの取り消しオプションとともに、コメントを含むインシデントの詳細が表示されます。

自分のオープンサービス要求: ワークスペースユーザーは所有するオープンサービス要求を表示および管理できます。

通知またはページ ユースケースワークフロー
サービス要求作成通知 新しいサービス要求が作成されると、インシデントの所有者は通知を受け取ります。
サービス要求解決SLAしきい値ヒット通知 新しいサービス要求の解決SLAが達成されなかった場合、インシデントの所有者は通知を受け取ります。
サービス要求応答SLAしきい値ヒット通知 新しいサービス要求の応答SLAが達成されなかった場合、インシデントの所有者は通知を受け取ります。
サービス要求ステータス変更通知 新しいサービス要求のステータスが変更されると、インシデントの所有者は通知を受け取ります。
自分のオープンサービス要求 ワークスペースユーザーが所有するオープンサービス要求のリストが表示されます。
サービス要求の詳細 コメントの追加およびサービス要求の取り消しオプションとともに、コメントを含むサービス要求の詳細が表示されます。
Cherwellの統合