GovNotifySpoke を設定

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:2分
  • JWT 認証を使用して ServiceNow インスタンスと GovNotify アカウントを統合し、ServiceNow 要求を認証します。

    始める前に

    • 統合ハブ サブスクリプションの要求
    • GovNotify スポークの有効化
    • 必要なロール:admin

    手順

    1. GovNotify アカウントで、API キーを作成します。
      1. アドミニストレーターとして GovNotify アカウントにログインします。
      2. 移動先 API 統合 をクリックし、[ API キー] をクリックします。
      3. [API キーを作成 (Create API key)] をクリックします。
      4. フォームで、API キーの名前を入力し、必要なキータイプを選択します。
        [API キーを作成 (Create API key)]。
      5. [続行] をクリックします。
        API キーは、{key_name}-{iss-uuid}-{secret-key-uuid} 形式で表示されます。たとえば、API キーが「my_test_key-26785a09-ab16-4eb0-8407-a37497a57506-3d844edf-8d35-48ac-975b-e847b4f122b0」の場合、次のようになります。
        • API キー名:my_test_key
        • iss (サービス ID):26785a09-ab16-4eb0-8407-a37497a57506
        • 秘密鍵または署名鍵:3d844edf-8d35-48ac-975b-e847b4f122b0
        詳細については、「GovNotify REST API ドキュメント」の「ヘッダー」を参照してください。
      6. [API キーをクリップボードにコピー (Copy API key to clipboard)] をクリックし、後で使用するために値を記録します。
        API キーをコピー。
    2. ServiceNow インスタンスでデフォルトの JWT キーレコードを設定します。
      1. 移動先 システム OAuth > JWT キー.
      2. レコード [GovNotify Key] を開きます。
      3. API キーからコピーした署名キーを [署名キー]に入力し ます。
      4. [更新] をクリックします。
    3. ServiceNow インスタンスでデフォルトの JWT プロバイダーレコードを設定します。
      1. 移動先 システム OAuth > JWT プロバイダー.
      2. レコード [GovNotify JWT Provider] を開きます。
      3. [標準要求] タブで、[iss] レコードをクリックします。
      4. API キーからコピーした [iss] (サービス ID) 値を [要求値] に入力します。
      5. [更新] をクリックします。
    4. ServiceNow インスタンスでデフォルトの認証情報レコードを設定します。
      1. 移動先 GovNotify スポーク > 認証情報.
      2. レコード [GovNotify Cred] を開きます。
      3. [JWT プロバイダー]で、構成した JWT プロバイダーを選択します。
      4. [更新] をクリックします。
    5. ServiceNow インスタンスのデフォルトの接続および資格情報エイリアスレコードを設定します。
      1. 移動先 接続 & 認証情報 > 接続および資格情報エイリアス.
      2. レコード [GovNotify] を開きます。
      3. [接続] タブで、[新規] をクリックします。
      4. フォームに、これらの値を入力します。
        表 : 1. HTTP(S) 接続フォーム
        フィールド 説明
        認証情報 設定した認証情報レコード。例:「GovNotify Cred」。
        接続 URL GovNotify アカウントに接続するための URL。「https://api.notifications.service.gov.uk」と入力します。
      5. [送信] をクリックします。