Налаштування інтеграції з Okta

​

Огляд

• account.locked — обліковий запис заблоковано
• mfa.factor.activated — активує додаткові фактори MFA
• auth.login.failed — не вдається увійти

​

Вибір способу підключення

​

Варіант A — API-токен (SSWS)

​

Що потрібно для Living Security

​

Передумови

• Щоб створити користувача службового облікового запису, призначити ролі адміністратора та створити API-токени, ви повинні мати роль Super Administrator в Okta.

​

Усунення несправностей

​

Варіант B — службовий застосунок OAuth 2.0

1. Client ID — унікальний ідентифікатор вашого застосунку Okta API Services.
2. Private Key (JWK) — приватний ключ RSA у форматі JSON Web Key, відкритий ключ якого зареєстровано у вашому застосунку Okta.
3. Okta Domain — лише піддомен вашого тенанта Okta (наприклад, dev-12345678), а не повне ім’я хоста.
4. Scopes — розділений пробілами список областей доступу (scopes) Okta Management API (наприклад, okta.users.read okta.logs.read).

​

Передумови:

• Ви повинні мати обліковий запис Okta. Зареєструйте безкоштовний обліковий запис розробника на developer.okta.com.

​

Крок 1: Створення застосунку Okta API Services

1. Увійдіть до Okta Admin Console.
2. На бічній панелі ліворуч перейдіть до Applications > Applications.
3. Натисніть Create App Integration.
4. Виберіть API Services як метод входу та натисніть Next.

5. Вкажіть назву застосунку та натисніть Save.
6. На вкладці General застосунку знайдіть свій Client ID — він знадобиться на завершальному кроці.
7. Встановіть для Client authentication значення Public key / Private key. Області доступу okta.* підтримуються лише з цим методом автентифікації.

8. Вимкніть Proof of possession (DPoP) — він не підтримується.

​

Крок 2: Генерація та реєстрація пари ключів RSA

Використання генератора ключів Okta

1. В Admin Console відкрийте свій застосунок API Services.
2. Перейдіть на вкладку General і прокрутіть до розділу PUBLIC KEYS.
3. Натисніть Add Key, а потім виберіть Generate new key.
4. Натисніть Save — Okta згенерує пару ключів і один раз покаже Private Key (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. В Admin Console відкрийте свій застосунок API Services.
2. Перейдіть на вкладку General і прокрутіть до розділу PUBLIC KEYS.
3. Натисніть Add Key, вставте JSON відкритого JWK, виведений наведеним вище скриптом, і натисніть Save.

​

Крок 3: Визначення Okta Domain

• В Admin Console в адресному рядку браузера відображатиметься URL-адреса на кшталт https://dev-12345678-admin.okta.com.
• Ваш Okta Domain — це лише піддомен (наприклад, dev-12345678), а не dev-12345678.okta.com.
• Також можна перейти до Settings > Account в Admin Console, щоб знайти свій домен Okta, а потім використати частину з піддоменом.

​

Крок 4: Надання застосунку областей доступу API

1. В Admin Console перейдіть до Applications > Applications і відкрийте свій застосунок.
2. Натисніть вкладку Okta API Scopes.
3. Надайте області доступу, потрібні вашій інтеграції: okta.users.read і okta.logs.read.

​

Крок 5: Призначення застосунку ролі адміністратора

1. В Admin Console перейдіть до Security > Administrators (або до Applications > Applications > ваш застосунок > Admin roles).
2. Натисніть Add administrator assignment і виберіть свій застосунок API Services.

3. Призначте роль Read-Only Administrator (або вищу, залежно від потрібних вам областей доступу).
4. Натисніть Save.

​

Крок 6: Введення облікових даних у Living Security Platform

1. Відкрийте форму, у якій потрібно автентифікуватися в Okta (Client Credentials).
2. Введіть свій Client ID.
3. Вставте свій Private Key (JWK) — повний об’єкт JSON зі скрипта вище (в один рядок або з форматуванням).
4. Введіть свій Okta Domain лише як піддомен тенанта (наприклад, dev-12345678).
5. Введіть Scopes у вигляді списку, розділеного пробілами (наприклад, okta.users.read okta.logs.read).
6. Надішліть форму, і автентифікація має завершитися успішно.