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

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分
  • カスタム統合プロファイルを作成して、ソフトウェアサブスクリプションを追跡し、SaaS アプリケーションの古いライセンスを最適化します。

    始める前に

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

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

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

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

    手順

    1. 移動先 すべて > SaaS ライセンス > 管理 > 新しいプロファイルを作成 をクリックし、[ カスタム統合プロファイル] を選択します。
    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.doinstance はインスタンスの名前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 アプリケーションの [接続および資格情報エイリアス] レコードに戻り、[ 新しい接続 & 資格情報の作成 ] 関連リンクをクリックして接続を再試行します。