カスタム統合プロファイルの作成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • カスタム統合プロファイルを作成して、ソフトウェアサブスクリプションを追跡し、SaaS アプリケーションの古いライセンスを最適化します。

    始める前に

    ServiceNow インスタンスでカスタム統合プロファイルを作成する前に、SaaS アプリケーションアドミンまたは開発者アカウントで認証方法を設定します。たとえば、OAuth アプリケーションや API トークンを作成します。

    OAuth アプリケーションを作成する場合は、必ず適切なスコープを有効にしてください。アプリには、ユーザーの読み取り、ユーザーアクティビティの読み取り、ユーザーの変更または削除を行うためのスコープが必要です。これらのスコープにより、統合はユーザーのリストを取得し、ユーザーアクティビティを取得し、未使用のサブスクリプションを再利用できます。OAuth アプリケーションのクライアント ID とクライアントシークレットを記録します。これらの値を ServiceNow インスタンスに入力します。

    API トークンを作成する場合は、API トークンの値を記録します。この値は ServiceNow インスタンスに入力します。

    必要なロール:sam_integrator または admin

    手順

    1. 移動先 すべて > SaaS ライセンス > 管理 > 新規プロファイルを作成 をクリックし、[ カスタム統合プロファイル (Custom Integration Profile)] を選択します。
    2. フォームのフィールドに入力します。
      表 : 1. 統合プロファイルフォーム
      フィールド 値
      表示名 任意の名前。たとえば、統合する SaaS アプリケーションの名前などです。
      接続と資格情報 ルックアップアイコン ( ルックアップアイコン) をクリックし、[ 新規] をクリックします。[接続および資格情報エイリアス] フォームで、フィールドに入力します。
      • 名前:任意の名前。たとえば、app_alias の場合、app は統合する SaaS アプリケーションの名前です。
      • アプリケーション:SaaS アプリケーションに接続するためのスポーク。このスポークは、既存の 統合ハブ スポークでも、新しく作成したスポークでもかまいません。システムは、[システム設定] 設定アイコンの [開発者] セクションで変更できます。
      • タイプ: 接続と認証情報。
      • 接続タイプ:HTTP。
      • 複数のアクティブな接続をサポート: 選択されていません。
      • デフォルトの再試行ポリシー: デフォルトの HTTP 再試行ポリシー。
      • 構成テンプレート:OAuth 認証コード権限許可タイプを使用している場合は、 OAuth 認証コード。API トークンを使用している場合は、 API キーを使用した基本認証。別の認証方法を使用している場合は、構成テンプレートを作成します。詳細については、「 構成テンプレートの作成 」および「 OAuth JWT ベアラー権限許可タイプのテンプレートの構成」を参照してください。
      [送信] をクリックします。
      ステータス 統合プロファイルのステータス。オプションは [ドラフト] と [公開済み] です。この値は、自動的に入力されます。
      プロファイルタイプ カスタム統合。この値は、自動的に入力されます。
    3. [保存] をクリックします。
    4. プレビューアイコン ( プレビューアイコン) をクリックし、[ レコードを開く] をクリックして、接続および資格情報エイリアスレコードを開きます。
    5. [新しい接続 & 資格情報の作成] 関連リンクをクリックします。
    6. OAuth 認証コード構成テンプレートを使用している場合は、次のようにフォームに入力します。
      表 : 2. 接続および資格情報フォームを作成
      フィールド 値
      接続 URL API のベース URL。
      認証 URL OAuth 認証コードのエンドポイントです。
      トークン URL アクセストークンを取得して更新する OAuth エンドポイント。
      トークン失効 URL アクセストークンを取り消す OAuth エンドポイント。
      OAuth リダイレクト URL https:// instance.service-now.com/oauth_redirect.do、instance はServiceNowインスタンスの名前です。
      リフレッシュトークンの有効期間 8640000.
      OAuth クライアント ID SaaS アプリケーションアドミンまたは開発者アカウントで作成したクライアント ID。
      OAuth クライアントシークレット SaaS アプリケーションアドミンまたは開発者アカウントで作成したクライアントシークレット。
      OAuth スコープ SaaS アプリケーションアドミンまたは開発者アカウントで OAuth アプリケーションに対して有効にしたスコープ。
    7. API キー構成テンプレートを使用した基本認証を使用している場合は、次のようにフォームに入力します。
      表 : 3. 接続および資格情報フォームを作成
      フィールド 値
      接続 URL SaaS アカウントの URL。
      ユーザー名 SaaS アプリケーションアドミンまたは開発者アカウントで API トークンを作成したアドミンユーザーのメールアドレス。
      API キー SaaS アプリケーションのアドミンまたは開発者アカウントで作成された API トークン。
      注:
      別の認証方法を使用している場合、使用可能なフィールドは作成した構成テンプレートによって決まります。
    8. [ 作成 ] をクリックし、統合のアクセス権を付与します。
      ヒント:
      新しいブラウザータブで SaaS アプリケーションアドミンアカウントにログインし、統合が正しいアカウントに接続されていることを確認します。
      接続が成功すると、[接続および資格情報エイリアス] レコードの [接続] 関連リストに新しい接続レコードが作成されます。接続に失敗した場合は、接続の試行中に作成された接続レコード、認証情報レコード、およびアプリケーションレジストリレコードを削除する必要があります。
      • 移動先 接続 & 認証情報 > 接続 SaaS アプリケーションの接続レコードを削除します。
      • 移動先 接続 & 認証情報 > 認証情報 SaaS アプリケーションの認証情報レコードを削除します。
      • 移動先 システム OAuth > アプリケーションレジストリ SaaS アプリケーションのアプリケーションレジストリレコードを削除します。
      SaaS アプリケーションの接続および資格情報エイリアスレコードに戻り、[ 新しい接続および資格情報の作成 ] 関連リンクをクリックして接続を再試行します。