Typemark Documentation

シングルサインオン

チームが SAML または OpenID Connect 経由で ID プロバイダーからサインインできるようにします。Enterprise で利用できます。

2026年11月19日更新

シングルサインオン (SSO) を使うと、チームは組織の ID プロバイダー(Okta、Microsoft Entra ID、Google Workspace、OneLogin、Auth0、Keycloak、SAML 2.0 または OpenID Connect に対応したものすべて)を通じて Typemark にサインインします。

SSO は Enterprise で利用できます。プロジェクトを所有するアカウントに紐づき、そのアカウントが所有するすべてのプロジェクトに適用されます。設定は Account > Single sign-on から行います。

1. メールドメインを証明する

SSO は、メールアドレスがお使いのドメインにある人をサインインさせるため、Typemark はそのドメインが組織のものであることを確認する必要があります。

  1. Your email domains で、acme.com などのドメインを追加します。
  2. Typemark が表示する TXT レコードを DNS に追加します。名前は _typemark-sso.acme.com、値は typemark-sso= で始まるものです。
  3. Verify をクリックします。DNS の変更が反映されるまで数分かかる場合があります。

1 つのドメインを同時に使用できるのは 1 つの組織だけです。

2. ID プロバイダーを接続する

SAML 2.0 または OpenID Connect を選択し、ID プロバイダーで Typemark をアプリとして追加して、必要な情報をコピーしてください。

ページに表示される次の 2 つの値を、プロバイダーに設定します。

  • Entity ID(audience または identifier とも呼ばれます)
  • ACS URL(reply URL または single sign-on URL とも呼ばれます)

ユーザーのメールアドレスは、emailAddress 形式の NameID として、または email という名前の属性として送信してください。

次に、プロバイダーの Single sign-on URL と signing certificate を Typemark に貼り付けます。Issuer は任意です。設定した場合、Typemark はそれ以外の発行元からのレスポンスを拒否します。

ページに表示される Redirect URI をプロバイダーに設定し、openid email profile スコープを要求してください。

次に、Issuer URL、Client ID、Client secret を Typemark に貼り付けます。その他の設定は、プロバイダーの /.well-known/openid-configuration から Typemark が自動で取得します。シークレットを保存すると、Typemark は以後その値を再表示しません。

Save をクリックし、続けて Turn on をクリックします。

サインイン

チームメンバーは typemark.dev/users/sso からサインインするか、サインインページの Single sign-on (SSO) を使います。業務用メールアドレスを入力すると、Typemark がプロバイダーへ案内します。

SSO で初めてサインインし、Typemark アカウントがない人には、Typemark がアカウントを作成します。プロジェクトに招待されていた場合は、そのプロジェクトに参加します。

Typemark で 二要素認証 を有効にしている人は、SSO のあとにも認証コードの入力が必要です。

シングルサインオンを必須にする

SSO が動作することを確認したら、ドメインのユーザーにとって SSO だけをサインイン方法にできます。Require single sign-on をクリックしてください。設定ミスでチームが締め出されないよう、先に一度 SSO でサインインしておく必要があります。

SSO が必須になると、次のようになります。

  • ドメインのユーザーは、パスワード、GitHub、メールリンクではサインインできなくなります。
  • 別の方法でサインイン済みのユーザーは、サインアウトされ、SSO を使うよう求められます。
  • 必須化する前に発行された API トークンと typemark login のセッションは使えなくなり、ユーザーは typemark login を再実行する必要があります。

ドメインに含まれないメールアドレスの人(業務委託者など)は、これまでどおりサインインできます。

無効にする

他の方法でのサインインを再び許可するには Make it optional をクリックし、SSO を停止するには Turn off をクリックします。アカウントが Enterprise を離れると、SSO は自動的に無効になり、全員がこれまでの方法でサインインします。パスワードを一度も設定したことがない人は、Forgot password からパスワードを設定できます。