GoogleシートServiceNow接続および資格情報エイリアスの構成

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

    • 接続エイリアスと認証情報エイリアスを構成して、 ServiceNow インスタンスと Google Drive 間の統合を認証します。

    始める前に

    必要なロール：アドミン

    このタスクについて

    接続および資格情報エイリアスレコードは、 ServiceNow インスタンスと Google Sheets の安全な接続を管理するために使用されます。接続エイリアスは、 Google スプレッドシートへの接続方法をシステムに指示します。Google Drive API のエンドポイント URL を定義し、誰が接続しているかをシステムに通知します。たとえば、OAuth トークンや API キーなどの認証の詳細が保存されます。

    手順

    1. 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
      1. [新規] を選択します。
      2. フォームで、フィールドに入力します。
        表 : 1. 接続および資格情報エイリアスフォーム
        フィールド 説明
        名前 エイリアスの名前。エイリアスには、英数字とアンダースコアのみを使用できます。たとえば、Sheets_Alias などです。

        アップグレード中に、認証情報レコード内のタグが接続および資格情報エイリアスに移行されます。認証情報タグに英数字とアンダースコア以外の特殊文字が含まれている場合は、アップグレード後もタグ名が保持されます。この移行されたエイリアスは引き続き使用できますが、名前を変更して命名の制限を満たすまでエイリアスを更新することはできません。
        ID 形式 scope_name.alias_name に基づく、接続および資格情報エイリアスの一意の識別子です。
        • スコープがグローバルである場合、ID はエイリアス名です。たとえば、グローバルスコープでシートエイリアスを作成すると、ID が シートに設定されます。
        • HR アプリケーションスコープで作業日エイリアスを作成すると、ID は x_hr_app.sheets に設定されます。
        親エイリアス Google ドライブの接続および資格情報エイリアスレコード。
        タイプ 認証情報または接続と認証情報のいずれかのタイプ。デフォルトは [接続と資格情報] です。
        接続タイプ 接続タイプの名前 (基本、HTTP、JDBC、JMS、Kafka のいずれか) です。デフォルトは [HTTP] です。
        複数の有効な接続をサポート エイリアスが複数のアクティブな接続をサポートするかどうかを示すオプション。接続 [sys_connection] テーブルを使用して接続を追加できます。接続関連リストを使用して、接続をエイリアスに関連付けることができます。
        デフォルトの再試行ポリシー エイリアスの再試行ポリシーです。詳細については、「再試行ポリシー」を参照してください。
        構成テンプレート 接続および認証情報レコードの作成に使用する構成テンプレートです。
      3. [送信] を選択します。
      接続および資格情報エイリアスレコードが作成されます。
    2. 接続および資格情報エイリアスレコードで使用する OAuth 2.0 認証情報を作成します。
      1. 移動先 すべて > 接続 & 認証情報 > 認証情報.
      2. [新規] を選択します。
      3. 認証情報タイプのリストから、[ OAuth 2.0 認証情報] を選択します。
      4. フォームで、フィールドに入力します。
        表 : 2. OAuth 2.0 認証情報フォーム
        フィールド 説明
        名前 アプリケーションによって提供されるデフォルトの認証情報と区別するための認証情報の一意の名前。たとえば、シート認証情報などです。
        アクティブ 認証情報をアクティブ化するオプション。
        OAuth エンティティプロファイル ServiceNowインスタンスでGoogle Sheets のアプリケーションレジストリを作成する でアプリケーションレジストリを実行したときに生成されたデフォルトの OAuth エンティティプロファイル。
        適用先 認証情報レコードをすべての MID サーバーに適用するか、特定の MID サーバーに適用するかを指定するオプション。特定の場合は、必要に応じて MID サーバー を追加してください。
        順序 ディスカバリーがデバイスへのログオンを試行するときにこの認証情報を試行する順序 (シーケンス)。数値が小さいほど、この認証情報がリストの上位に表示されます。
      5. [送信] を選択します。
        OAuth 2.0 認証情報レコードが作成されます。
      6. [認証情報] リストから OAuth 2.0 認証情報レコードを開きます。
      7. [統合タイプ] リストから [個人] を選択します。
    3. エイリアスの接続レコードを作成します。
      1. 移動先 すべて > 接続 & 認証情報 > 接続.
      2. [新規] を選択します。
      3. 接続タイプのリストから、[ HTTP(s) 接続] を選択します。
      4. フォームで、フィールドに入力します。
        表 : 3. HTTP(S) 接続フォーム
        フィールド 説明
        名前 接続の名前。このフィールドは、テーブル上で一意でなければなりません。

        たとえば、Sheets 認証情報などです。
        認証情報 この接続で使用する認証情報。

        たとえば、手順 2 で作成した OAuth 2.0 認証情報レコードを選択します。
        接続エイリアス 実行時に接続と資格情報を解決する接続エイリアス。接続エイリアスごとに一度に 1 つの接続のみがアクティブになります。
        アクティブ この接続を有効にするオプション。
        ドメイン アクションまたはアクティビティを実行するドメイン。
        URL ビルダー ホスト、ポート、ベースパスなどの入力に基づいて URL を構築するためにシステムを使用するオプション。
        接続 URL 指定された Web リンクへの接続に MID サーバー が使用する URL。

        URL ビルダーが選択されていない場合は、このフィールドに接続 URL を入力します。たとえば、 https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart&fields=id などです。
        相互認証 プロトコルプロファイルを使用して認証を有効にするオプション。
        注:
        相互認証を選択すると、接続 URL (プロトコル + :// + host:port +URL) が作成されます。相互認証が選択されていない場合は、接続 URL (プロトコルプロファイル + :// + host:port +URL) が作成されます。

        このフィールドは、[ URL ビルダー ] が選択されている場合にのみ表示されます。
        MID サーバーを使用 [MID サーバー詳細構成] セクションのフィールドを定義するオプション。
        この間に接続が成功しない場合、接続要求はタイムアウトします。システムのデフォルトの接続タイムアウト値を使用するには、このフィールドを空のままにします。
        注:
        接続タイムアウトの値をゼロに設定すると、接続が古くなる可能性があるため、設定しないでください。
        接続タイムアウト システムがホスト接続の成功を待機する秒数。
      5. [送信] を選択します。
      接続レコードが作成されます。
    4. エイリアスレコードのsys_idをコピーします。
      注:
      このsys_idは、 シートへのエクスポートエイリアス システムプロパティを設定するときに必要です。
      1. 移動先 すべて > 接続 & 認証情報 > 接続と認証情報エイリアス.
      2. [接続および資格情報エイリアス] リストから、ステップ 1 で作成したエイリアスを選択して開きます。
      3. エイリアスページのヘッダーを右クリックし、[ sys_idをコピー] を選択します。
    5. シートへのエクスポートエイリアスシステムプロパティを構成します。
      1. ナビゲーションフィルターで、「sys_properties.list」と入力します
        システムプロパティ [sys_properties] テーブル内のプロパティの全リストが表示されます。
      2. [新規] を選択します。
      3. フォームで、フィールドに入力します。
        表 : 4. システムプロパティフォーム
        フィールド 説明
        名前 作成しているプロパティの名前。この場合は、 glide.oauth.export.to.sheets.alias です。
        説明 プロパティの機能を説明する簡単な説明文。
        タイプ データタイプこの場合は 文字列です。
        値 プロパティの値。この場合は、手順 4 でエイリアスレコードからコピーしたsys_idを貼り付けます。
      4. [送信] を選択します。
        注:
        [キャッシュを無視] チェックボックスをオンにすると、パラメーターが変更されたときにサーバーのキャッシュがフラッシュされます。

    タスクの結果

    接続および資格情報エイリアスレコードは、 ServiceNow インスタンスを Google Sheets に接続するように構成されています。