ガイド

シングルサインオン

自社の ID プロバイダー(SAML または OpenID Connect)でワークスペースにサインインできるようにし、そこから得た情報でロールを割り当て、全員に必須にする方法です。

5 分で読めます

サインインの方法このセクションへのリンクをコピー

  • Google・Microsoft・Okta でサインインのボタンは、ワークスペースを運用する側がワークスペース全体で有効にします。管理者のページには表示されず、あなたが行うことはありません。
  • 自社の ID プロバイダーは、SAML または OpenID Connect(OIDC)で、管理者が 管理 › IDプロバイダー に登録します。サインイン画面で仕事用のメールアドレスを入力すると、そのドメインに応じてプロバイダーに送られます。Microsoft Entra ID、Okta、Google Workspace はいずれも、以下の方法で登録できます。
  • メールアドレスとパスワード:管理者が管理 › メンバーで追加した人は、1 回限りのリンクから自分のパスワードを設定します。サインインとメンバーの追加をご覧ください。

プロバイダーに設定するアドレスこのセクションへのリンクをコピー

最初にプロバイダーの名前(例:acme-okta)を決めてください。以下のアドレスの一部になります。<your-workspace> をワークスペースのアドレスに、<name> をその名前に置き換えます。

項目アドレス
OIDC のリダイレクト(サインインのコールバック)URIhttps://<your-workspace>/api/auth/sso/callback/<name>
SAML の応答(ACS)URLhttps://<your-workspace>/api/auth/sso/saml2/sp/acs/<name>
SAML のオーディエンス(SP エンティティ ID)プロバイダーを追加するときに Issuer に入力する値そのもの
SAML のサービスプロバイダーのメタデータ(追加後)https://<your-workspace>/api/auth/sso/saml2/sp/metadata?providerId=<name>
テストサインインのリダイレクト URI(OIDC)https://<your-workspace>/api/admin/identity-provider-tests/callback

プロバイダーを追加するこのセクションへのリンクをコピー

  1. 管理 › IDプロバイダー を開き、プロバイダーを追加 を選びます。
  2. SAML か OIDC を選び、名前、メールドメイン(複数はカンマ区切り)、発行者(Issuer)を入力します。
  3. SAML ではサインオン URL を入力し、プロバイダーから受け取ったメタデータ XML を貼り付けます。署名用の証明書はこの中に含まれます。OIDC ではクライアント ID とクライアントシークレットを入力します。それ以外はワークスペースが <Issuer>/.well-known/openid-configuration から読み取ります。
  4. 追加を選びます。プロバイダーが 登録済み に、プロトコル・ドメイン・Issuer・署名証明書とともに表示されます。プロバイダーはワークスペースに属するため、すべての管理者が見られます。クライアントシークレットは暗号化して保存されます。

Microsoft Entra IDこのセクションへのリンクをコピー

OIDC の場合:Entra 管理センターの アプリの登録 で登録を作成し、Web プラットフォームのリダイレクト URI に上の OIDC リダイレクト URI を設定します。クライアントシークレットを作成します。ワークスペースでは アプリケーション(クライアント)ID をクライアント ID に、シークレットの値をクライアントシークレットに、https://login.microsoftonline.com/<tenant-id>/v2.0 を Issuer に入力します。

SAML の場合:エンタープライズ アプリケーション で独自のアプリケーションを作成し、SAML を選びます。識別子(エンティティ ID) を Issuer に入力する値に、応答 URL を上の SAML 応答 URL に設定し、フェデレーション メタデータ XML をダウンロードして、サインオン URL とともにワークスペースに貼り付けます。

Oktaこのセクションへのリンクをコピー

OIDC の場合:Okta 管理コンソールで、種類 OIDC・Web アプリケーションのアプリ統合を作成し、サインインのリダイレクト URI に上の OIDC リダイレクト URI を設定します。そのクライアント ID とシークレットを使い、Issuer には https://acme.okta.com のような Okta のアドレスを入力します。

SAML の場合:種類 SAML 2.0 のアプリ統合を作成します。シングルサインオン URL を上の SAML 応答 URL に、オーディエンス URI(SP エンティティ ID)を Issuer に入力する値に設定し、アプリの IdP メタデータをワークスペースにコピーします。

Google Workspaceこのセクションへのリンクをコピー

Google 管理コンソールの ウェブアプリとモバイルアプリ で カスタム SAML アプリ を追加します。ACS の URL を上の SAML 応答 URL に、エンティティ ID を Issuer に入力する値に設定し、IdP メタデータをダウンロードして、使う人に対してアプリをオンにします。

使い始める前にテストするこのセクションへのリンクをコピー

OIDC プロバイダーでは、行の テストサインイン でプロバイダーを往復し、返ってきた内容を確認できます。Issuer が一致するか、このクライアント向けに発行されたか、nonce が一致するか、期限切れでないか、そして含まれていたクレームです。誰もサインインせず、アカウントも作られません。先に上のテスト用リダイレクト URI をプロバイダーで許可してください。SAML プロバイダーのテストサインインにはまだ対応していないため、テスト用アカウントで一度サインインして確かめてください。

サインイン情報からのロールこのセクションへのリンクをコピー

IDプロバイダーのページ下部の サインイン情報からのロール は、登録したプロバイダーでのサインインのたびに 1 つのクレーム(既定は groups)を読み、その値からロールとグループを割り当てます。サインイン時にルールを適用する をオンにし、ルールを 50 件まで追加して(クレームにこの値があるとき に応じて ロール と グループ を割り当て)、保存前に クレームの値で試す で確認します。値は大文字と小文字を区別しません。管理者はカスタムロールより、カスタムロールはメンバーより優先され、ルールが最後の管理者や自分が与えていないロールを下げることはありません。適用できないルールがあってもサインインは止まりません。

シングルサインオンを必須にするこのセクションへのリンクをコピー

  • 管理 › エンタープライズ管理 › サインイン で SSO を必須にするをオンにします。以後は登録した SAML または OIDC のプロバイダーだけがサインインでき、Google・Microsoft・Okta のボタンは拒否されます。サインイン画面は仕事用のメールアドレスを求め、会社のアカウントで続けるを表示します。
  • プロバイダーを登録するまではオンにできず、変更には最近サインインしていることが必要です。
  • 保存すると、登録したプロバイダーですでにサインインした人と、ワークスペースの緊急用管理者を除き、他の全員のセッションが終了します。
  • ワークスペースの緊急用管理者は 管理者のサインインから別の方法でサインインできるため、プロバイダーが故障しても全員が締め出されることはありません。そのようなサインインはすべて監査ログに記録されます。

署名証明書このセクションへのリンクをコピー

各プロバイダーの行には、SAML メタデータまたは OIDC プロバイダーが公開する鍵から読み取った署名証明書の有効期限が表示されます。期限の 30 日前、7 日前、1 日前と期限切れ後に一度、管理者に通知が届き、行は 30 日前から黄色に、期限切れで赤になります。期限が切れるとそのプロバイダーでのサインインはできなくなります。証明書を変えるには、利用の少ない時間にプロバイダーを削除し、新しいメタデータで追加し直してください。

ディレクトリからのプロビジョニングこのセクションへのリンクをコピー

ワークスペースでプロビジョニングが有効な場合、管理 › エンタープライズ管理 に SCIM プロビジョニングがオンと表示され、ディレクトリのベースアドレス https://<your-workspace>/api/auth/scim/v2 が示されます。ディレクトリ用トークン で Okta、Entra などのディレクトリ用のトークンを発行します。トークンは一度だけ表示され、同時に 5 個まで有効にでき、切り替えの間は古いトークンを最長 1 週間併用できます。ディレクトリで無効にした人は、セッションが終了し、コンピューターが停止し、接続したアカウントが無効になります。サインインは引き続きプロバイダー経由です。

最終更新日