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

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：6分

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

    始める前に

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

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

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

    このタスクについて

    ソフトウェア資産ワークスペースを使用している場合、コア UIでカスタム統合プロファイルを作成するオプションは非アクティブです。

    手順

    1. カスタム統合プロファイルに移動します。
      インターフェイスアクション
      Core UI (コア UI)
      1. 次のように移動する。 All (すべて) > SaaS ライセンス > アドミニストレーション > 新しいプロファイルを作成.
      2. [カスタム統合プロファイル] を選択します。
      ソフトウェア資産ワークスペース
      1. 次のように移動する。 ライセンス操作 > ユーザー登録 > 直接統合プロファイル > .
      2. [New (新規)] を選択します。
      3. ドロップダウンリストから [カスタム ] を選択します。
      4. [Continue (続行)] を選択します。
    2. フォームのフィールドに入力します。
      表 : 1. カスタム統合プロファイルフォーム
      フィールド Value (値)
      表示名 カスタム統合プロファイルの名前。

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

    次のタスク

    ユーザーを取得するデータストリームアクションの作成SaaS関連アナリティクスを表示します SaaS 概要ダッシュボード.

    調整は、サブスクリプションでもスケジュール済みジョブとして、またはオンデマンドで実行されます。調整結果は、 ライセンスワークベンチ (ソフトウェア資産管理クラシックアプリケーション) または ライセンス使用状況ビュー (ソフトウェア資産ワークスペース) で表示できます。これらの結果を使用して、ライセンスコンプライアンスの状況を判断し、コンプライアンス違反を修正します。