サードパーティ OAuth プロバイダーの使用
各クライアントアプリケーションは、OAuth 認証に参加するためにインスタンスに登録する必要があります。
始める前に
このタスクについて
注:
たとえば、ユーザーのスケジュール済みイベントを読み取ってイベントを作成するために OAuth 2.0 アクセストークンを必要とするサードパーティのカレンダーサービスと統合したい場合があります。カレンダーサービスをサードパーティ OAuth プロバイダーとして構成します。この構成により、カレンダーサービスからアクセストークンを取得し、そのトークンを使用して ServiceNowからサービスに対して要求を行うことができます。ServiceNow は、 ServiceNow からサードパーティ API への要求を許可するサードパーティ OAuth プロバイダーのみをサポートしています。
手順
- 移動先 すべて > システム OAuth > アプリケーションレジストリー をクリックし、[ 新規] をクリックします。
-
インターセプターページで、[ サードパーティ OAuth プロバイダーに接続] をクリックし、フォームに入力します。
フィールド 説明 名前 アクセスするアプリケーションを識別する一意の名前。 クライアント ID アプリケーションの一意の ID。インスタンスは、アクセストークンを要求するときにクライアント ID を使用します。認証サーバーからクライアント ID を取得する必要があります。 クライアントシークレット [必須]インスタンスとアプリケーションが相互通信を許可するために使用する共有シークレット文字列。正しいクライアントシークレットを入力しないと、トークンは発行されません。 OAuth API スクリプト このオプションを使用すると、修正された OAuthUtil スクリプトインクルードを参照できます。デフォルトの OAuthUtil スクリプトインクルードファイルをコピーして名前を変更し、サードパーティの OAuth プロバイダーと一致するように特定の要求と応答用にこのバージョンを変更します。修正したスクリプト名には、プリフィックス OAuth を付ける必要があります。OAuthUtil を参照して、適切なメソッドで必要な body パラメーターを追加します。 ロゴ URL アプリケーションロゴとして使用するイメージを含む URL。 デフォルトの権限許可タイプ 権限許可のタイプ: - 認証コード:アクセストークンを取得するためにクライアントに付与され、リソースへのアクセス権を取得するために使用されるコード。このオプションを選択する場合は、認証 URL (認証サーバーの URL) が必要です。
- リソース所有者のパスワード認証情報:リソースへのアクセス権の取得を試行するユーザーのユーザー名とパスワード。
- クライアント認証情報:どちらもアクセストークンを取得するために使用されるクライアント ID とクライアントシークレット。このメソッドはリフレッシュトークンを提供しません。
- JWT ベアラー:認証サーバーは、ID とセキュリティ情報をセキュリティドメイン間で共有できるようにする JWT トークンを検証します。
- SAML2 ベアラー:SAML2 アサーションを生成し、プロバイダーとアクセストークンのアサーションを交換します。注:SuccessFactors への送信要求では、[SAML2 ベアラー] をデフォルトの権限許可タイプとして使用します。
リフレッシュ トークンの有効期間 リフレッシュトークンの有効期間 (秒単位)。 アクセス可能 このレジストリにアクセスできるアプリケーションスコープ。 アクティブ アプリケーションレジストリがアクティブであることを示すチェックボックス。 認証 URL 認証コード権限許可タイプを使用している場合は、ユーザーを認証するエンドポイントの URL。別の ServiceNow インスタンスにアクセスしている場合は、URL に /oauth_auth.doを追加します。トークン URL トークンを取得および更新するためにインスタンスが使用するトークンエンドポイントの場所。別の ServiceNow インスタンスにアクセスしている場合は、URL に /oauth_token.doを追加します。リダイレクト URL 認証コードを受信するアプリケーションエンドポイント。インスタンスで URL を自動生成するには、フィールドを空のままにします。別の ServiceNow インスタンスにアクセスしている場合は、URL に /oauth_redirect.doを追加します。トークン失効 URL インスタンスがトークンを取り消すために使用するエンドポイントの場所。別のインスタンスにアクセスしている場合は、URL に /oauth_revoke.doを追加します。コメント アプリケーションに関連付ける追加情報。 埋め込みリスト OAuth エンティティプロファイル OAuth プロバイダーに関連付けられているプロファイル。プロファイルには権限許可タイプが含まれています。プロファイル名をクリックして、[ OAuth エンティティプロファイル] フォームに移動します。 OAuth エンティティスコープ OAuth プロバイダーに関連付けられているエンティティスコープ。スコープは、アプリケーションがアクセスできるサービスを識別します。スコープ名をクリックして、[ OAuth エンティティスコープ] フォームに移動します。 -
[送信] をクリックします。レコードは、アプリケーションレジストリー [oauth_entity] テーブルに保存されます。
システムにより、OAuth プロバイダータイプのレコードがアプリケーションレジストリ [oauth_entity] テーブルに作成されます。インスタンスは、指定された権限許可タイプを使用してデフォルトのプロファイルも自動生成しますが、スコープはありません。