SSOとSAML
SSOとSAMLを使ってGitBookのコンテンツを共有する方法を学びましょう
組織メンバーを手動で管理するのは、小規模チームや、細かく制御したい人にとっては問題ありませんが、場合によっては、もっと自動化された方法で公開したいだけということもあります。GitBook では、基本的なメールドメイン SSO と、より複雑な SAML 連携という 2 つの方法でこれを設定できます。
メールドメインによるシングルサインオン
組織を作成または管理する際に、GitBook の組織へのアクセスを許可したいメールドメインの一覧を追加できます。つまり、設定した SSO ドメインに一致する検証済みメールアドレスを持つ人なら誰でも、組織に参加できます。
メールドメイン SSO は SSO 組織の 設定セクションで有効にできます。SSO アクセスを許可したいメールドメインをカンマ区切りで入力すれば完了です。
SAML ベースのシングルサインオン （SSO）により、メンバーは任意のアイデンティティプロバイダー（IdP）を通じて GitBook にアクセスできます。
GitBook は既存のアイデンティティプロバイダー（IdP）と簡単に連携できるため、他のサービスプロバイダーと同じ認証情報とログイン体験で、従業員に GitBook へのシングルサインオンを提供できます。
SSO を使うと、従業員は GitBook のログインページではなく、使い慣れたアイデンティティプロバイダーの画面から GitBook にログインできます。その後、従業員のブラウザが GitBook へ転送します。SSO が有効で GitBook 独自のログイン機構が無効化されている場合、IdP が GitBook へのアクセスを許可します。このようにして、認証のセキュリティは IdP に移され、他のサービスプロバイダーと連携して管理されます。
GitBook で SSO を利用するための前提条件
貴社のアイデンティティプロバイダー（IdP）は、 SAML 2.0 規格をサポートしている必要があります。
IdP で管理者権限を持っている必要があります。
SAML を設定する GitBook 組織の管理者である必要があります。
GitBook での設定
あなたは 組織管理者 である必要があります。GitBook 組織で SSO を有効にするには。
IdP で SSO を設定した後、メタデータを入力できるようになります。セットアップが成功すると、管理者には確認ダイアログが表示され、エンドユーザー向けの SSO ログイン URL が表示されます。 GitBook はセットアップ完了時に告知メールを送信しません. GitBook へ SSO でアクセスできるように、会社の従業員へ通知し（ログイン URL も伝え）るのは管理者の責任です。
SAML プロバイダーを登録するには、IdP のメタデータから次の項目が必要です:
1つの label – ここは任意の値で構いません。ログインページに表示されます
1つの entity ID
1つの シングルサインオン URL
1つの X.509 証明書 – 証明書全体を必ずコピー＆ペーストしてください！
IdP での設定
ほとんどの SAML 2.0 対応アイデンティティプロバイダーでは、設定のためにサービスプロバイダー（この場合は GitBook）に関する同じ情報が必要です。これらの値は GitBook 組織ごとに固有で、次の場所で確認できます: 設定 -> SSO タブで、SSO を有効にしたい GitBook 組織にあります。
これらの値のほとんどは、そのまま IdP にコピーして SAML の設定を完了できます。
GitBook では次の要件があります: NameID にユーザーのメールアドレスが含まれていること。技術的には、次を求めています: urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress を Name-ID 形式として使用します。多くのプロバイダー（Google など）では、次のような形式を設定できます: EMAIL.
カスタム属性
GitBook は SAML アサート応答から次のカスタム属性を取得し、ユーザー作成時に使用します。
first_name
first_name 、 last_name フィールドは組み合わされ、GitBook でのユーザーの表示名が作成されます
last_name
first_name 、 last_name フィールドは組み合わされ、GitBook でのユーザーの表示名が作成されます
エンドユーザーアカウントの作成
メンバーを追加するには、IdP でそれぞれのアカウントを作成します。新しいメンバーが初めて IdP 経由で GitBook にログインすると、自動 IdP プロビジョニングによって GitBook アカウントが作成されます。ユーザーは組織メンバーとして組織リソースにアクセスできます。
設定には小文字のメールアドレスが必要です。大文字小文字が混在したメールアドレスは使用しないでください。
アカウントの削除
IdP からメンバーを削除すると、そのユーザーは対応する GitBook アカウントにサインインできなくなります、 ただし GitBook からアカウントが削除されるわけではありません. GitBook 組織からもアカウントを削除することをおすすめします。
アクセスの制御
SAML SSO を設定すると、GitBook アカウントにアクセスできるユーザーの管理は IdP 側の責任になります。
セキュリティに関する注意
Identity Provider から取得したものと同じメールアドレスの既存の GitBook アカウントをお持ちで、さらにサインインしようとしている組織のメンバーでない場合、セキュリティ上の理由により、SAML 設定を使って自動的にその組織へ追加することはできません。選択肢は 2 つあります:
既存の GitBook アカウントを削除してから、SAML を使って目的の組織にログインしてください。その後、GitBook が新しいアカウントを作成し、あなたは組織に追加されます
または、管理者に組織へ招待してもらってください:
組織で「SSO の強制」が有効になっていない場合、組織の管理者は組織設定のメンバーページからユーザーを招待できます。
組織で「SSO の強制」が有効になっている場合、管理者は GitBook の 招待 API エンドポイントを使って、組織へユーザーを招待する必要があります。この API 呼び出しは次のようになります;
最終更新
役に立ちましたか？