OktaでSSOを設定する
OktaでLingo.dev用のSAMLアプリを作成し、ユーザーを割り当てて組織に接続し、SCIMでメンバーをプロビジョニングします。
このガイドでは、SAML 2.0を使ってOktaとLingo.devを接続します。アプリ連携を作成できるOkta管理者アカウントが必要です。また、Enterpriseプランを利用しているLingo.dev組織のオーナーである必要があります。Lingo.devでのSSOの仕組みについては、シングルサインオンをご覧ください。
Lingo.devで設定 → SSOを開いたままにしてください。この画面から2つの値をOktaにコピーします。
アプリ連携を作成する #
- Okta管理コンソールにサインインします。
- アプリケーション → アプリケーション(新しい管理コンソールではアプリケーションとリソース → アプリケーション)に移動し、アプリ連携を作成を選択します。
- SAML 2.0を選び、次へを選択します。
- アプリ名に
Lingo.devを入力し、次へを選択します。
SAMLを設定する #
次の項目を設定し、それ以外は既定値のままにします。
| Oktaの項目 | 値 |
|---|---|
| シングルサインオンURL | https://auth.lingo.dev/auth/v1/sso/saml/acs(Lingo.devのACS URL) |
| これを受信者URLと宛先URLに使用する | 選択済み |
| オーディエンスURI(SPエンティティID) | https://auth.lingo.dev/auth/v1/sso/saml/metadata(Lingo.devのエンティティID) |
| 既定のリレー状態 | 空欄 |
| 名前ID形式 | メールアドレス |
| アプリケーションのユーザー名 | メール |
属性ステートメントに属性を1つ追加します。
| 名前 | 名前の形式 | 値 |
|---|---|---|
email | 未指定 | user.email |
名前ID形式をメールアドレスに設定し、このemail属性を追加すると、Lingo.devで必要なメールアドレスがOktaから送信されます。
新しいOkta組織では、アプリの作成中に属性ステートメントが表示されません。その場合は、完了を選択してから属性を追加します。アプリのサインオンタブを開き、属性ステートメントセクションで式を追加を選択します。名前にemail、式にuser.profile.emailを入力し、保存を選択します。
次へを選択します。フィードバックのステップで、社内アプリを追加するOktaの顧客ですを選び、完了を選択します。
メタデータURLをコピーする #
アプリのサインオンタブで、メタデータの詳細セクションにあるメタデータURLをコピーします。https://your-company.okta.com/app/exk.../sso/saml/metadataのような形式です。
ユーザーを割り当てる #
- アプリの割り当てタブを開きます。
- 割り当てを選択し、ユーザーに割り当てまたはグループに割り当てを選択します。
- 各ユーザーまたはグループの横にある割り当てを選択し、完了を選択します。
Okta経由でLingo.devにサインインできるのは、割り当てられたユーザーだけです。
Lingo.devで接続する #
- 設定 → SSOを開きます。
- 認証プロバイダーのメタデータURLに、OktaのメタデータURLを貼り付けます。
- メールドメインに、自社のメールドメインをカンマ区切りで入力します。
- 接続を選択します。
ドメインが拒否された場合は、ドメインのルールをご覧ください。
サインインをテストする #
- ブラウザのプライベートウィンドウを開き、Lingo.devのサインインページにアクセスします。
- SSOで続行を選択し、割り当てられたユーザーのメールアドレスを入力して、サインインを選択します。
- Oktaにサインインします。
組織のメンバーとしてLingo.devに戻ります。組織ページに表示されるメールアドレスを確認してください。表示されるのはOktaでサインインしたアカウントのメールアドレスで、入力したものと同じとは限りません。たとえば、アプリを設定した管理者のOktaセッションがブラウザに残っている場合、Oktaはそのアカウントで処理を続行します。アプリに割り当てられていない管理者には「ユーザーはこのアプリケーションに割り当てられていません」と表示されます。このため、テストにはプライベートウィンドウが必要です。
テストはLingo.devから開始してください。OktaダッシュボードにあるSAMLアプリ自体のタイルからはサインインできず、サインアウトしたままLingo.devのホームページに移動します。ダッシュボードからサインインするには、Oktaダッシュボードからサインインするの手順でブックマークを追加してください。
テストが成功したら、SSOを必須にすることができます。まず、有効にするの説明に従い、自分のSSOアカウントをオーナーにしてください。
Oktaダッシュボードからサインインする #
メンバーがサインインに使えるLingo.devのタイルを用意するには、ダッシュボード用サインインリンクを開くブックマークアプリを追加します。その後、SAMLアプリ自体のアイコンを非表示にし、メンバーにはブックマークだけが表示されるようにします。
- Lingo.devで設定 → SSOを開き、ダッシュボード用サインインリンクをコピーします。
https://lingo.dev/auth/sso?domain=example.comのような形式です。 - Okta管理コンソールで、アプリケーション → アプリケーション(新しい管理コンソールではアプリケーションとリソース → アプリケーション)に移動し、アプリカタログを参照を選択します。
- ブックマークアプリを検索して選び、連携を追加を選択します。
- 一般設定で、名前に
Lingo.devを入力し、URLにリンクを貼り付けます。アプリケーションアイコンをユーザーに表示しないは選択しないまま、完了を選択します。 - ブックマークの割り当てタブで、SAMLアプリと同じユーザーまたはグループを割り当てます。
- Lingo.devのSAMLアプリを開きます。一般タブのアプリ設定で編集を選択します。
- アプリケーションの表示で、アプリケーションアイコンをユーザーに表示しないとOktaモバイルアプリにアプリケーションアイコンを表示しないを選択し、保存を選択します。
SAMLアプリへのユーザーの割り当ては維持してください。アプリは非表示になるだけで、引き続きサインインに使われます。
これで、メンバーにはLingo.devのタイルが1つ表示されます。タイルからLingo.devを開くと、メールアドレスの入力を求められることなく、Oktaを経由してサインイン済みの状態でLingo.devに戻ります。
SCIMでメンバーをプロビジョニングする #
Oktaでは、SCIMでLingo.devのメンバーを管理し、グループを通じてロールを設定できます。まず、このガイドに従ってSSOを設定してください。Lingo.devでのSCIMの仕組みについては、SCIMでメンバーをプロビジョニングするをご覧ください。
- Lingo.devでSCIMキーを生成します。
- Okta管理コンソールで、Lingo.devのSAMLアプリを開きます。一般タブのアプリ設定で編集を選択します。
- プロビジョニングをSCIMに設定し、保存を選択します。アプリにプロビジョニングタブが追加されます。
- プロビジョニングタブで連携を開き、編集を選択します。
次の項目を設定します。
| Oktaの項目 | 値 |
|---|---|
| SCIMコネクタのベースURL | https://api.lingo.dev/v2/scim(Lingo.devのSCIMベースURL) |
| ユーザーの一意識別子フィールド | userName |
| 対応するプロビジョニング操作 | 新規ユーザーをプッシュ、プロフィール更新をプッシュ、グループをプッシュ。インポート操作は選択しないでください。OktaはLingo.devからユーザーやグループをインポートしません。 |
| 認証モード | HTTPヘッダー。ベアラートークンとしてSCIMキーを貼り付けます。 |
コネクタ設定をテストを選択します。テストが成功したらテスト画面を閉じ、保存を選択します。
プロビジョニングタブでアプリへを開き、編集を選択します。ユーザーを作成、ユーザー属性を更新、ユーザーを無効化を有効にし、保存を選択します。
ユーザーを作成の設定を保存するまで、OktaからLingo.devにユーザーは送信されません。保存後は、割り当てたユーザーごとにLingo.devで保留中の招待が作成され、初めてSSOでサインインしたときにメンバーになります。
Oktaでユーザーの割り当てを解除するか、ユーザーを無効化すると、OktaがLingo.devでもそのユーザーを無効化し、組織のメンバーから削除します。ユーザーを削除するをご覧ください。
Oktaグループでロールを設定する #
- Oktaグループの名前が、
TranslatorなどのLingo.devのロール名と一致していることを確認します。 - アプリのグループをプッシュタブで、グループをプッシュ、名前でグループを検索の順に選択します。
- グループを見つけて、保存を選択します。
アプリの割り当てに使うグループとは別のグループをプッシュしてください。Oktaでは、1つのグループを両方の用途に使うことはできません。Oktaがプッシュするのはアプリに割り当てられたメンバーだけです。そのため、プッシュするグループの全員を、直接または別のグループを通じてアプリに割り当ててください。
Oktaはグループを同じ名前のロールに関連付けます。グループのメンバーにはそのロールが付与され、グループから削除されたユーザーからはロールが解除されます。グループと同じ名前のロールがない場合、プッシュ時に「指定された名前のロールがありません」というエラーが表示されます。Lingo.devでロールを作成してから、グループを再度プッシュしてください。
グループのプッシュを停止した際に、アプリ内のグループも削除するかOktaに確認された場合、削除を選ぶとメンバーからそのロールが解除されます。ロール自体はLingo.devに残ります。
トラブルシューティング #
| 問題 | 対処方法 |
|---|---|
| Oktaへのサインイン後、Lingo.devに「シングルサインオンが完了しませんでした」と表示される。 | オーディエンスURI(SPエンティティID) とシングルサインオンURLを確認してください。それぞれLingo.devのエンティティIDとACS URLに完全に一致し、末尾にスラッシュが付いていない必要があります。 |
| Lingo.devに「認証プロバイダーからメールアドレスが送信されませんでした」と表示される。 | 名前ID形式をメールアドレスに、アプリケーションのユーザー名をメールに設定し、email属性ステートメントを追加してください。設定ウィザードではuser.email、サインオンタブではuser.profile.emailを指定します。 |
| アプリに割り当てられていないとOktaに表示される。 | 割り当てタブで、該当ユーザーまたはそのユーザーが所属するグループを割り当ててください。割り当て済みユーザーのメールアドレスを入力したのに、Oktaで管理者アカウントが表示される場合は、ブラウザにOktaのセッションが残っています。Oktaからサインアウトするか、プライベートウィンドウを使用してください。 |
| Lingo.devに「シングルサインオンの完了に時間がかかりすぎました。もう一度お試しください。」と表示される。 | 初回の多要素認証の設定などで、Oktaへのサインインに約5分を超える時間がかかったことが原因です。Lingo.devからもう一度お試しください。次の試行ではサインインできます。 |
| Lingo.devに「サインインしましたが、組織に追加できませんでした。」と表示される。 | SSOでもう一度サインインしてください。引き続き失敗する場合は、設定 → SSOに接続開始日時が表示されているか、オーナーに確認してもらってください。 |
| Lingo.devに、使用しているドメインについて「シングルサインオンが設定されていません」と表示される。 | 設定 → SSOでドメインを追加するか、入力したメールアドレスを確認してください。 |
コネクタ設定をテストまたはプロビジョニングが401 Unauthorizedで失敗する。 | SCIMキーが更新されたか、失効しています。連携に現在のキーを貼り付けるか、Lingo.devで新しいキーを生成してください。 |
| Oktaで割り当てたユーザーが、設定 → チームの招待タブに表示されない。 | アプリへでユーザーを作成が有効になっていることを確認してください。この設定を保存する前に割り当てたユーザーについては、Oktaのプロビジョニングタスク一覧を開き、処理を再試行してください。 |
その他のメッセージについては、トラブルシューティングをご覧ください。