---
sourceDocument: Yokohama データと自動化
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - ja-JP

ft:publication_title :

    - Yokohama データと自動化

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Okta スポークの設定

# Okta スポークの設定 {#ariaid-title1}

* リリースバージョン: Yokohama
* 
* 更新日 2025年01月30日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：10分

Okta スポークを Okta と統合して、Okta でのさまざまなアクションを自動化します。たとえば、Okta でのユーザーのアクティブ化を自動化することができます。統合するには、API キーまたは OAuth 認証を使用して ServiceNow インスタンスを Okta と接続します。

## 始める前に

* 統合ハブサブスクリプションを要求します。
* ServiceNow インスタンスの Okta スポークをアクティブ化します。
* Okta 開発者ポータルのアカウント
* 必要なロール：admin
{#set-up-okta-v1.1.1__ul_l2l_mph_gfb}

## このタスクについて

要件に応じて、API キーまたは OAuth 認証情報を使用してスポークを設定できます。ただし、ServiceNow ドメインに対して一度に使用できるエイリアスは 1 つだけです。

## API キーを使用して Okta スポークを設定 {#ariaid-title2}

API キーを使用して ServiceNow インスタンスと Okta アカウントをデータ連携し、ServiceNow 要求を認証します。

### 認証を要求するための API キーの生成 {#ariaid-title3}

Okta の組織または開発者アカウントで API キーを生成して、Okta の開発者または組織のアカウントによって接続レコードを認証できるようにします。

#### 始める前に

Oktaの要件：

* Okta の組織または開発者アカウント
* 必要なロール：Okta アドミニストレーター
{#configure-okta-account-v1.1.1__ul_nhk_cnh_gfb}

#### このタスクについて

API キーを使用すると、Okta の組織または開発者アカウントが ServiceNow インスタンスからのアクセス要求を認証できるようになります。

#### 手順

1. <https://developer.okta.com/login/> にログインします。
2. 左側のパネルで、 セキュリティAPI.
3. \[API\] ページで、 \[トークン\] を選択します。  
4. \[トークンを作成 (Create token)\] を選択します。
5. \[トークンを作成 (Create token)\] ウィンドウで、トークンの名前を入力します。
6. \[トークンを作成 (Create token)\] を選択します。  
   トークンが作成されます。

7. API トークンをコピーし、安全な場所に保存します。  
   トークンの有効期限に注意してください。

{#configure-okta-account-v1.1.1__steps_j3p_ndz_4fb}

### Okta スポークの API キー認証情報レコードの作成 {#ariaid-title4}

認証情報レコードを、作成した Okta アプリケーションに作成します。Okta スポーク接続および資格情報エイリアスでは、これらの認証情報を使用してアクションを許可します。

#### 始める前に

必要なロール：admin

#### 手順

1. 移動先 すべて接続 \& 認証情報認証情報.
2. \[新規\] を選択します。
3. \[API キー認証情報\] を選択します。
4. フォームに入力します。  
   {#create-credential-okta-v1.1.1__table_lwy_g1z_4fb__entry__2}

   | フィールド | 必要な値 |
   |-|-|
   | 名前 | レコードを一意に識別するカスタムの名前です。たとえば、「<kbd class="ph userinput">Okta 認証情報</kbd>」などです。 |
   | アクティブ | 認証情報レコードをアクティブ化して、Okta アカウントへの接続に使用できるようにします。 |
   | API キー | `Okta アカウントで SSWS <API トークン>` の形式で生成した API トークン。<kbd class="ph userinput">&lt;API トークン&gt;</kbd> を API トークンに置き換えます。 API トークンの生成方法については、「[認証を要求するための API キーの生成](https://servicenow-prod.fluidtopics.net/sF8x~8YcKfiyMQ4sAM4ttw#configure-okta-account-v1.1.1 "Okta の組織または開発者アカウントで API キーを生成して、Okta の開発者または組織のアカウントによって接続レコードを認証できるようにします。")」を参照してください。 |
   | 適用先 | この認証情報を使用できる MID サーバーです。たとえば、\[すべての MID サーバー\] を選択します。 |
   | 順序 | この認証情報が Okta API へのアクセスを試行するときに使用される順序 (シーケンス)。番号が小さいほど、この認証情報がリストの上位に表示されます。多くの認証情報を使用する場合、またはログイン試行が 3 回失敗してセキュリティによってユーザーがロックアウトされた場合、認証情報の順序を確立します。すべての認証情報の順序番号が同じ (または順序番号がない) 場合、インスタンスは認証情報をランダムな順序で試行します。たとえば、「<kbd class="ph userinput">100</kbd>」と入力します。 |
   | 認証情報エイリアス | Okta スポークの認証情報エイリアスで、Okta API への接続時に、ランタイムで解決します。 |
   [ ]

   {#create-credential-okta-v1.1.1__table_lwy_g1z_4fb}
5. \[送信\] を選択します。
{#create-credential-okta-v1.1.1__steps_t5s_2fy_4fb}

### OktaSpoke の接続レコードを作成します。 {#ariaid-title5}

接続レコードを Okta API に作成します。Okta スポーク接続および資格情報エイリアスでは、これらの接続を使用して Okta でアクションを実行します。

#### 始める前に

必要なロール：admin

#### 手順

1. 移動先 すべて接続 \& 認証情報接続と認証情報エイリアス.
2. \[Okta\] のレコードを開きます。
3. \[接続\] タブから、\[新規\] を選択します。
4. フォームに入力します。  
   {#create-connection-okta-v1.1.1__table_any_shp_gfb__entry__2}

   | フィールド | 必要な値 |
   |-|-|
   | 名前 | 接続レコードを一意に識別する名前を入力します。たとえば、<kbd class="ph userinput">Okta 接続</kbd>を入力します。 |
   | 認証情報 | Okta 用に作成された認証情報レコードを選択します。たとえば、\[Okta 認証情報\] を選択します。 |
   | 接続 URL | Okta の組織 URL を入力します。たとえば、<kbd class="ph userinput">https://dev-418994.oktapreview.com</kbd> を入力します。 |
   [ ]

   {#create-connection-okta-v1.1.1__table_any_shp_gfb}
5. \[送信\] を選択します。
{#create-connection-okta-v1.1.1__steps_zwz_fhz_4fb}

## OAuth 認証情報を使用した Okta の設定 {#ariaid-title6}

Okta にカスタム OAuth アプリケーションを作成して ServiceNow インスタンスと Okta アカウントを統合し、ServiceNow 要求を認証します。

### 始める前に

* Okta 開発者コンソールにアクセスします。
* 必要なロール：アドミン
{#setup-okta-oauth-cred__ul_czf_cwq_gnb}

### Okta での OAuth アプリケーションの作成 {#ariaid-title7}

Okta 開発者アカウントでカスタム OAuth アプリケーションを作成し、ServiceNow インスタンスからの要求の OAuth 2.0 認証を有効にします。

#### 始める前に

必要なロール：アドミン

Okta 開発者または組織アカウントへのアドミニストレーターアクセス

#### 手順

1. <https://developer.okta.com/login/> にログインします。
2. 左側のパネルで、 アプリケーションアプリケーション.
3. 「アプリケーション」ページで、 \[アプリ統合の作成 (Create App Integration)\] を選択します。  
4. \[アプリ統合の新規作成 (Create a new app integration)\] ウィンドウで、\[OIDC - OpenID コネクト\] を選択します。
5. 選択  
   * OIDC - OpenID コネクト
   * Web アプリケーション
   {#conf-okta-app__ul_hgb_xzg_wyb}
6. \[次へ\] を選択します。
7. フォームに入力します。  
   {#conf-okta-app__table_jwz_52h_wyb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | アプリ統合名 | OAuth アプリケーションのカスタム名です。 |
   | ロゴ | OAuth アプリケーションのロゴです。ロゴのアップロードはオプションです。 |
   | 権限許可タイプ | ビルドしているアプリケーションのタイプに応じて使用する OAuth 2.0 フローのタイプです。適切なオプションを選択する方法については、「<https://developer.okta.com/docs/concepts/oauth-openid/#openid-connect>」を参照してください。以下のオプションを選択します。 * 認証コード * トークンのリフレッシュ * 暗黙 (ハイブリッド) * 暗黙的な許可タイプの ID トークンを許可 * 暗黙的な許可タイプのアクセストークンを許可 (Allow access token with implicit grant type) {#conf-okta-app__ul_mjd_dwh_wyb} {#conf-okta-app__ul_ljd_dwh_wyb} |
   | サインインリダイレクト URI (Sign-in redirect URIs) | Okta から認証応答と ID トークンを受信する URI です。次の形式で ServiceNow インスタンス URL を入力します： <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do</kbd>。 |
   | サインアウトリダイレクト URI (Sign-out redirect URIs) | ユーザーセッションをクローズするために Okta に接続する URI です。次の形式で ServiceNow インスタンス URL を入力します： <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/oauth_redirect.do</kbd>。 |
   | ベース URI | 自己ホスト Okta ウィジェットの URI です。ベース URI の指定はオプションです。 |
   | 制御対象アクセス (Controlled access) | 組織内の Okta 統合へのアクセス権を割り当てるオプションです。アクセス権を割り当てるには： * 組織内の全員にアクセス権を割り当てるには、\[組織内の全員にアクセスを許可する (Allow everyone in your organization to access)\] を選択します。 * 選択したグループにアクセス権を割り当てるには、\[アクセスを選択したグループに制限 (Limit access to selected groups)\] を選択し、\[選択されたグループ\] フィールドにグループ名を入力します。 * 統合後にアクセス権を割り当てるには、\[今はグループの割り当てをスキップ (Skip group assignment for now)\] を選択します。 {#conf-okta-app__ul_uqk_5hh_wyb} |
   [表 : 1. 新しい Web アプリの統合]

   {#conf-okta-app__table_jwz_52h_wyb}
8. \[保存\] を選択します。  
   OAuth アプリケーションが作成されます。
9. Okta API にアクセスするための権限を付与します。
   1. \[ Okta API スコープ\] を選択します。  
   2. \[ アクション\] で、 API の \[権限許可\] を選択します。  
      注:  
      これらはすべて、すべてのスポークアクションが機能するために必要な OAuth スコープです。使用可能なスポークアクションのサブセットのみを使用している場合は、独自のセキュリティ要件に基づいて必要なスコープのみを選択できます。
      * okta.users.manage
      * okta.apps.manage
      * okta.logs.read
      * okta.groups.read
      * okta.groups.manage
      * okta.users.read
      * okta.apps.read
      * okta.eventHooks.read
      * okta.eventHooks.manage

      {#conf-okta-app__ul_dnd_svh_wyb}API スコープの詳細については、[Okta 開発者向けドキュメント](https://developer.okta.com/docs/)の「[許可されたスコープを定義](https://developer.okta.com/docs/guides/implement-oauth-for-okta/define-allowed-scopes/)」を参照してください。
   {#conf-okta-app__substeps_lzp_nvh_wyb}

### Okta スポークの接続レコードの作成 {#ariaid-title8}

Okta サーバーに接続するための情報を含む接続レコードを作成します。ServiceNow インスタンスはこのフォームを使用して、OAuth アプリケーションに認証要求を送信します。

#### 始める前に

重要:  
[Okta での OAuth アプリケーションの作成](https://servicenow-prod.fluidtopics.net/sF8x~8YcKfiyMQ4sAM4ttw#conf-okta-app "Okta 開発者アカウントでカスタム OAuth アプリケーションを作成し、ServiceNow インスタンスからの要求の OAuth 2.0 認証を有効にします。")のステップ 9 で説明したように別の OAuth スコープを設定した場合は、この手順を実行しないでください。代わりに、 [Connect to a third-party OAuth provider](https://www.servicenow.com/docs/access?context=connect-3rd-party-oauth-provider&version=yokohama&pubname=yokohama-platform-security&ft:locale=en-US) で概説されている手順を実行し、 [Okta での OAuth アプリケーションの作成](https://servicenow-prod.fluidtopics.net/sF8x~8YcKfiyMQ4sAM4ttw#conf-okta-app "Okta 開発者アカウントでカスタム OAuth アプリケーションを作成し、ServiceNow インスタンスからの要求の OAuth 2.0 認証を有効にします。")のステップ 9 で付与された Okta Web アプリケーションに対応する OAuth スコープを追加します。

必要なロール：admin

#### 手順

1. 移動先 すべてプロセスの自動化ワークフロースタジオ.
2. \[統合\] タブを選択します。
3. \[すべての接続を検索\] フィールドに「<kbd class="ph userinput">Okta</kbd>」と入力します。  
   注:  
   \[送信\] タブがデフォルトで有効になっています。これが有効になっていることを確認します。
4. \[Okta スポーク\] タイルで、\[詳細を表示\] を選択します。  
5. \[構成\] を選択します。
6. フォームに、これらの値を入力します。  
   {#add-okta-conn__table_fcw_r1h_3mb__entry__2}

   | フィールド | 説明 |
   |-|-|
   | 名前 | Okta インスタンスとの間で確立された接続の名前最初の接続のデフォルト名は、\[接続および資格情報エイリアス\] ページの \[接続および資格情報\] フォームで指定された名前と一致するように自動的に割り当てられます。カスタム名を指定するには、\[接続を追加\] を選択し、接続を作成します。 |
   | 接続 URL | Okta サーバーに接続するための URL。URL 形式は https://\[yourOktaDomain\].com です。 |
   | API バージョン | Okta API のバージョン。 |
   | 認証 URL | Okta の OAuth アプリケーションが Okta リソースサーバーへのアクセス認証を求めるために提供する URL。形式は <kbd class="ph userinput">https://{youroktadomain}.com/oauth2/{API version}/authorize</kbd> です。 |
   | トークン URL | アクセストークンを取得するための URL。形式は <kbd class="ph userinput">https://{youroktadomain}.com/oauth2/{API version}/token</kbd> です。 |
   | トークン失効 URL | 以前に発行されたアクセストークンとリフレッシュトークンの取り消しまたはキャンセルをクライアントアプリケーションが要求できるようにする、OAuth 承認サーバーによって提供される URL。形式は <kbd class="ph userinput">https://{youroktadomain}.com/oauth2/{API version}/revoke</kbd> です。 |
   | OAuth クライアント ID | Okta 開発者のアカウントで生成されたクライアント ID。 |
   | OAuth クライアントシークレット | Okta 開発者のアカウントで生成されたクライアントのシークレット。 |
   | OAuth リダイレクト URL | URL を ServiceNow インスタンスにリダイレクトします 。形式は <kbd class="ph userinput">https://{instance-name}.service-now.com/oauth_redirect.do</kbd> です。 |
   [表 : 2. 接続を設定]

   {#add-okta-conn__table_fcw_r1h_3mb}
7. \[OAuth トークンを設定して取得 (Configure and Get OAuth Token)\] を選択します。  
   Okta Spoke に対して OAuth アクセストークンが生成されます。  
   注:  
   OAuth アクセストークンを付与する前に、Okta にログインする必要があります。
{#add-okta-conn__steps_ftf_csq_gnb}