こんにちは！たつみんです🖐️
今回は、私が所属しているSaaS企業で、Okta Integration Network (OIN) にSAML連携を公開した際の備忘録と裏話をお届けします。サクッと読める内容なので、「OIN登録ってこんな感じなんだ」と軽い気持ちで読んでいただければと思います。
OINとは？
OktaでSaaSのSAML設定やSCIM設定などの連携をテンプレート化したものです。
このテンプレートにより、Oktaとの連携が数ステップで完了できるようになります。
企業や組織は、セキュアかつ簡単にSaaSアプリをOktaに統合できます。
OINにSAML連携を登録するために必要なもの
- Okta Developer Edition テナント
- Okta Browser Plugin
- Customer configuration document guidelines 公開用のオンラインストレージ
OINへの公開までの流れ
基本的な流れとしては、以下のガイドに従い作成し、申請を行います
Submit an SSO integration with the OIN Wizard
登録の大まかな流れ
- Okta Developer Edition テナントを作成
- Okta管理画面からApplication > Your OIN Integrationsにアクセスし、ウィザードに従って設定
- 英語でCustomer configuration document guidelinesを作成し、オンラインで公開
- SAML連携アプリケーションを作成し、セルフテストを実施
- Okta (本国) へ申請
- フィードバックで修正点があれば修正後、再度審査依頼
- 審査OKの連絡後、公開日を調整
- Okta Japan担当者とプレスリリースに関して打ち合わせ
- OIN公開を確認し、プレスリリース公開
Your OIN Integrations での操作
Your OIN Integrationsは非常に使いやすいので、簡単にご紹介します。
画面は以下の3つのステップで構成されており、順番に進めるだけで申請まで完了できます。
- Select your protocol
- Configure your integration
- Test Integration experience
-
Select your protocol内で「Security Assertion Markup Language (SAML)」を選択します。
-
Configure your integration内でOINカタログ上に表示されるプロパティを設定します。
- 続いてIntegration variablesで変数の定義を行います。
- SAMLプロパティを定義します。ここでは3. で定義した変数をorg.<変数名>で活用できます。
-
Test Integration experience内のTest integrationでOkta担当者が利用する審査時に利用するテスト用アカウントを指定します。
- IdP-initiatedやSP-initiated、Just-In-Time provisioningに対応するか選択します。SP-initiatedの場合は、テスト開始用のURLを指定します。
- Generate Instanceからアプリケーションを作成し、Add To Testerをクリックします。
- OIN Submission Tester (SSO only)でRun Testを実行します。
- テスト結果が全てクリアしたらSubmit integrationをクリックし、申請を行います。
Run Testの挙動
Run Testを実行すると自動的にシークレットブラウザが起動し、Okta Browser Pluginによりテストが進行します。私たちのSaaSはSP-initiatedとJust-In-Time provisioningに対応していたため、それぞれのテストを実行しました。テスト結果は自動的にJSONファイルとして作成され、エクスポートすることが可能です。
苦労した点
当初、別システム「OIN Manager」から申請を行う必要がありましたが、作業開始後に「Okta Developer Edition」から申請する方式に切り替わりました。このため、混乱が一部ありましたが、Oktaの最新の申請プロセスに従えばスムーズに進められるはずです。
また、セルフテストでうまくいかない点もありましたが、Okta Japanのエンジニアにサポートしていただき、無事に進行できました。
まとめ
Okta Integration NetworkへのSAML連携登録は、Your OIN Integrationsの直感的な操作により、スムーズに進められます。SaaSをOktaと連携させる際は、このプロセスが役立つかもしれません。今後OINにSaaSを登録する方の参考になれば幸いです。
Discussion