Okta 連携のセットアップ

​

概要

• account.locked — アカウントのロック
• mfa.factor.activated — 追加の MFA 要素の有効化
• auth.login.failed — ログインの失敗

​

接続方法の選択

​

オプション A — API トークン (SSWS)

​

Living Security に必要な情報

​

前提条件

• サービスアカウントユーザーの作成、管理者ロールの割り当て、API トークンの作成を行うには、Okta の Super Administrator である必要があります。

​

トラブルシューティング

​

オプション B — OAuth 2.0 サービスアプリケーション

1. クライアント ID - Okta API Services アプリケーションの一意の識別子。
2. 秘密鍵 (JWK) - JSON Web Key 形式の RSA 秘密鍵。対応する公開鍵は Okta アプリケーションに登録されている必要があります。
3. Okta ドメイン - 完全なホスト名ではなく、Okta テナントのサブドメインのみ（例: dev-12345678）。
4. スコープ - Okta Management API のスコープをスペースで区切った一覧（例: okta.users.read okta.logs.read）。

​

前提条件:

• Okta アカウントが必要です。無料の開発者アカウントは developer.okta.com からサインアップできます。

​

ステップ 1: Okta API Services アプリケーションを作成する

1. Okta 管理コンソールにログインします。
2. 左側のサイドバーで、Applications > Applications に移動します。
3. Create App Integration をクリックします。
4. サインイン方法として API Services を選択し、次 をクリックします。

5. アプリケーションに名前を付けて、保存 をクリックします。
6. アプリケーションの General タブで クライアント ID を確認します。最後のステップで必要になります。
7. Client authentication を Public key / Private key に設定します。okta.* スコープは、この認証方法でのみサポートされています。

8. Proof of possession (DPoP) を無効にします。サポートされていません。

​

ステップ 2: RSA 鍵ペアを生成して登録する

Okta の鍵生成機能を使用する

1. 管理コンソールで、API Services アプリケーションを開きます。
2. General タブに移動し、PUBLIC KEYS セクションまでスクロールします。
3. Add Key をクリックし、Generate new key を選択します。
4. 保存 をクリックします。Okta が鍵ペアを生成し、秘密鍵 (JWK) を一度だけ表示します。
5. 秘密鍵の JSON をすぐにコピーして保存してください。再表示されることはありません。

6. 公開鍵は自動的にアプリケーションに登録されます。

独自の鍵を作成する

const { generateKeyPairSync } = require('crypto');
const { privateKey, publicKey } = generateKeyPairSync('rsa', { modulusLength: 2048 });

const privateJwk = privateKey.export({ format: 'jwk' });
const publicJwk  = publicKey.export({ format: 'jwk' });

// Assign a kid — must match between private and public JWK
const kid = require('crypto').randomUUID();
privateJwk.kid = kid;
publicJwk.kid  = kid;

console.log('=== PUBLIC JWK (upload to Okta) ===');
console.log(JSON.stringify(publicJwk, null, 2));
console.log('\n=== PRIVATE JWK (paste into the Living Security Platform) ===');
console.log(JSON.stringify(privateJwk));

1. 管理コンソールで、API Services アプリケーションを開きます。
2. General タブに移動し、PUBLIC KEYS セクションまでスクロールします。
3. Add Key をクリックし、上記のスクリプトが出力した公開 JWK の JSON を貼り付けて、保存 をクリックします。

​

ステップ 3: Okta ドメインを確認する

• 管理コンソールでは、ブラウザーのアドレスバーに https://dev-12345678-admin.okta.com のような URL が表示されます。
• Okta ドメイン はサブドメインのみ（例: dev-12345678）であり、dev-12345678.okta.com ではありません。
• または、管理コンソールの 設定 > Account で Okta ドメインを確認し、そのサブドメイン部分を使用します。

​

ステップ 4: アプリケーションに API スコープを付与する

1. 管理コンソールで、Applications > Applications に移動し、対象のアプリケーションを開きます。
2. Okta API Scopes タブをクリックします。
3. 連携に必要なスコープ（okta.users.read と okta.logs.read）を付与します。

​

ステップ 5: アプリケーションに管理者ロールを割り当てる

1. 管理コンソールで、セキュリティ > Administrators に移動します（または、Applications > Applications > 対象のアプリ > Admin roles に移動します）。
2. Add administrator assignment をクリックし、API Services アプリケーションを選択します。

3. Read-Only Administrator ロール（または、必要なスコープに応じてそれ以上のロール）を割り当てます。
4. 保存 をクリックします。

​

ステップ 6: Living Security Platform に認証情報を入力する

1. Okta (Client Credentials) で認証するためのフォームを開きます。
2. クライアント ID を入力します。
3. 秘密鍵 (JWK) を貼り付けます。上記のスクリプトで出力された JSON オブジェクト全体を、1 行でも整形された形式でも構いません。
4. Okta ドメイン を、テナントのサブドメインのみで入力します（例: dev-12345678）。
5. スコープ をスペース区切りの一覧で入力します（例: okta.users.read okta.logs.read）。
6. フォームを送信すると、認証が完了します。