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にコピーします。

アプリ連携を作成する #

  1. Okta管理コンソールにサインインします。
  2. アプリケーション → アプリケーション(新しい管理コンソールではアプリケーションとリソース → アプリケーション)に移動し、アプリ連携を作成を選択します。
  3. SAML 2.0を選び、次へを選択します。
  4. アプリ名にLingo.devを入力し、次へを選択します。

SAMLを設定する #

次の項目を設定し、それ以外は既定値のままにします。

Oktaの項目値
シングルサインオンURLhttps://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のような形式です。

ユーザーを割り当てる #

  1. アプリの割り当てタブを開きます。
  2. 割り当てを選択し、ユーザーに割り当てまたはグループに割り当てを選択します。
  3. 各ユーザーまたはグループの横にある割り当てを選択し、完了を選択します。

Okta経由でLingo.devにサインインできるのは、割り当てられたユーザーだけです。

Lingo.devで接続する #

  1. 設定 → SSOを開きます。
  2. 認証プロバイダーのメタデータURLに、OktaのメタデータURLを貼り付けます。
  3. メールドメインに、自社のメールドメインをカンマ区切りで入力します。
  4. 接続を選択します。

ドメインが拒否された場合は、ドメインのルールをご覧ください。

サインインをテストする #

  1. ブラウザのプライベートウィンドウを開き、Lingo.devのサインインページにアクセスします。
  2. SSOで続行を選択し、割り当てられたユーザーのメールアドレスを入力して、サインインを選択します。
  3. Oktaにサインインします。

組織のメンバーとしてLingo.devに戻ります。組織ページに表示されるメールアドレスを確認してください。表示されるのはOktaでサインインしたアカウントのメールアドレスで、入力したものと同じとは限りません。たとえば、アプリを設定した管理者のOktaセッションがブラウザに残っている場合、Oktaはそのアカウントで処理を続行します。アプリに割り当てられていない管理者には「ユーザーはこのアプリケーションに割り当てられていません」と表示されます。このため、テストにはプライベートウィンドウが必要です。

テストはLingo.devから開始してください。OktaダッシュボードにあるSAMLアプリ自体のタイルからはサインインできず、サインアウトしたままLingo.devのホームページに移動します。ダッシュボードからサインインするには、Oktaダッシュボードからサインインするの手順でブックマークを追加してください。

テストが成功したら、SSOを必須にすることができます。まず、有効にするの説明に従い、自分のSSOアカウントをオーナーにしてください。

Oktaダッシュボードからサインインする #

メンバーがサインインに使えるLingo.devのタイルを用意するには、ダッシュボード用サインインリンクを開くブックマークアプリを追加します。その後、SAMLアプリ自体のアイコンを非表示にし、メンバーにはブックマークだけが表示されるようにします。

  1. Lingo.devで設定 → SSOを開き、ダッシュボード用サインインリンクをコピーします。https://lingo.dev/auth/sso?domain=example.comのような形式です。
  2. Okta管理コンソールで、アプリケーション → アプリケーション(新しい管理コンソールではアプリケーションとリソース → アプリケーション)に移動し、アプリカタログを参照を選択します。
  3. ブックマークアプリを検索して選び、連携を追加を選択します。
  4. 一般設定で、名前にLingo.devを入力し、URLにリンクを貼り付けます。アプリケーションアイコンをユーザーに表示しないは選択しないまま、完了を選択します。
  5. ブックマークの割り当てタブで、SAMLアプリと同じユーザーまたはグループを割り当てます。
  6. Lingo.devのSAMLアプリを開きます。一般タブのアプリ設定で編集を選択します。
  7. アプリケーションの表示で、アプリケーションアイコンをユーザーに表示しないとOktaモバイルアプリにアプリケーションアイコンを表示しないを選択し、保存を選択します。

SAMLアプリへのユーザーの割り当ては維持してください。アプリは非表示になるだけで、引き続きサインインに使われます。

これで、メンバーにはLingo.devのタイルが1つ表示されます。タイルからLingo.devを開くと、メールアドレスの入力を求められることなく、Oktaを経由してサインイン済みの状態でLingo.devに戻ります。

SCIMでメンバーをプロビジョニングする #

Oktaでは、SCIMでLingo.devのメンバーを管理し、グループを通じてロールを設定できます。まず、このガイドに従ってSSOを設定してください。Lingo.devでのSCIMの仕組みについては、SCIMでメンバーをプロビジョニングするをご覧ください。

  1. Lingo.devでSCIMキーを生成します。
  2. Okta管理コンソールで、Lingo.devのSAMLアプリを開きます。一般タブのアプリ設定で編集を選択します。
  3. プロビジョニングをSCIMに設定し、保存を選択します。アプリにプロビジョニングタブが追加されます。
  4. プロビジョニングタブで連携を開き、編集を選択します。

次の項目を設定します。

Oktaの項目値
SCIMコネクタのベースURLhttps://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グループでロールを設定する #

  1. Oktaグループの名前が、TranslatorなどのLingo.devのロール名と一致していることを確認します。
  2. アプリのグループをプッシュタブで、グループをプッシュ、名前でグループを検索の順に選択します。
  3. グループを見つけて、保存を選択します。

アプリの割り当てに使うグループとは別のグループをプッシュしてください。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のプロビジョニングタスク一覧を開き、処理を再試行してください。

その他のメッセージについては、トラブルシューティングをご覧ください。