Holarch

管理

シングルサインオンと SCIM

組織の SAML 2.0 ID プロバイダー(Okta、Microsoft Entra ID、Microsoft AD FS、Google Workspace、Ping)、またはセルフホスト型サーバーの Active Directory を直接接続し、メールドメインを確認し、シングルサインオンを必須にし、グループをロールに対応付け、SCIM 2.0 でアカウントをプロビジョニングします。

使い方 →

このページの内容
  1. 概念
  2. 使い方
    1. メールドメインを確認
    2. ID プロバイダーを接続
    3. シングルサインオンをオンにする
    4. シングルサインオンを必須にする
    5. SCIM でアカウントをプロビジョニング
    6. ID プロバイダーの証明書が変わるとき
    7. 複数の組織のための会社のサインイン(セルフホスト型)
    8. 部門プロジェクトへのアクセス(セルフホスト型)
  3. サインインのルール
    1. 2 段階サインイン
  4. 属性
    1. グループとロールの対応
  5. SCIM
    1. SCIM グループと部門(セルフホスト型)
  6. ID プロバイダーを設定
    1. Okta
    2. Microsoft Entra ID
    3. Microsoft AD FS
    4. Google Workspace
    5. Ping Identity
  7. 会社ディレクトリ(Active Directory / LDAP)
    1. 会社ディレクトリを設定
    2. ディレクトリのグループから部門へ
    3. サインインできるユーザー
    4. 定期確認
    5. 会社ディレクトリでの 2 段階サインイン
  8. 上限とセキュリティに関する注記

組織は、メンバーが仕事用のアカウントで Holarch にサインインできるようにできます。Holarch がサービスプロバイダーで、組織の ID プロバイダー(Okta、Microsoft Entra ID、Microsoft AD FS、Google Workspace、Ping Identity、または任意の SAML 2.0 プロバイダー)が本人確認を行います。ID プロバイダーは、SCIM 2.0 を通じて Holarch のアカウントを作成、更新、無効化することもできます。

シングルサインオンは、組織管理者が組織設定 → 組織 → アクセスとサインイン → シングルサインオンで設定します。ホスト型サービスとセルフホスト型サーバーで動作し、デスクトップアプリでは動作しません。セルフホスト型サーバーには、ドメインの確認(DNS の検索)と URL からのメタデータの読み取りのために、外部へのアクセスが必要です。セルフホスト型サーバーは、ID プロバイダーを使わずに、Active Directory などの LDAP ディレクトリで会社アカウントを自ら確認することもできます:会社ディレクトリ(Active Directory / LDAP)を参照してください。

注:シングルサインオンと SCIM のプロビジョニングは、(組織の)Team プランの一部です。バージョン 2.29.0 より前にこれらを使っていた組織は引き続き使えます。プランがない場合、設定は保持されますが、メンバーはパスワード(パスワードをお忘れですか?で設定)、Google、または Microsoft でサインインし、SCIM のリクエストは拒否されます。

概念

用語意味
確認済みドメイン組織が DNS の TXT レコードで管理していることを証明したメールドメイン(example.com など)。シングルサインオンと SCIM は、確認済みドメインのアドレスでのみ動作します。1 つのドメインを確認できるのは 1 つの組織だけです。
ID プロバイダー (IdP)メンバーをサインインさせるサービス:そのエンティティ ID(発行者)、サインイン URL、署名証明書。
サービスプロバイダー (SP)この組織にとっての Holarch。各組織に独自のエンティティ ID、ACS URL、メタデータ URL があります。
管理対象のメンバーメールアドレスが確認済みドメインにあり、組織管理者ではない組織のメンバー。シングルサインオンを必須にするはこれらのメンバーに適用されます。
SCIM トークンID プロバイダーが、この組織について Holarch の SCIM API を呼び出すのに使うシークレット。個人に結び付いていません。

使い方

メールドメインを確認

  1. 組織設定を開いて組織を選択し、アクセスとサインインを開いてシングルサインオンを探します。
  2. メールドメインに、メンバーのアドレスのドメインを入力し、ドメインを追加を選択します。
  3. 表示された TXT レコードを公開します:名前 _holarch-challenge.<domain>、値 holarch-domain-verification=…。
  4. 確認を選択します。DNS の変更が反映されるまで数分かかることがあります。ドメインに確認済みと表示されるまで、もう一度確認します。

メンバーが使うすべてのドメインを追加します(例:example.com と eng.example.com)。1 つの組織につき最大 20 ドメインです。

ID プロバイダーを接続

  1. ID プロバイダーで、Holarch の ID プロバイダーにある値を使って SAML 2.0 アプリケーションを作成します(下記のプロバイダー別のセクションを参照)。
    • エンティティ ID(オーディエンス):https://app.holarch.app/api/auth/saml/<organization id>/metadata
    • ACS URL(応答 URL):https://app.holarch.app/api/auth/saml/<organization id>/acs
    • メタデータ URL:エンティティ ID と同じです。SP のメタデータをインポートするプロバイダーはこれを使えます。
  2. プロバイダーのメタデータ XML またはそのメタデータ URL を上部のボックスにコピーし、メタデータを読み取るを選択します。Holarch がエンティティ ID、サインイン URL、証明書を入力します。自分で入力することもできます。
  3. 属性とロールで、プロバイダーが一般的でない属性名を使う場合はその名前(属性を参照)、新しいメンバーのロール、任意のグループとロールの対応を設定します。
  4. ID プロバイダーを保存を選択し、パスワードを入力します。

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

  1. この組織のシングルサインオンにチェックを付けます。保存済みの ID プロバイダーと確認済みドメインが必要です。
  2. メンバーにメンバー用のサインインリンクを伝えるか、サインイン画面でシングルサインオンでサインインを選んで仕事用のメールアドレスを入力するよう伝えます。
  3. まず 1 人のメンバーで試します。

メンバーが初めてサインインすると、Holarch がアカウントを(確認済み、パスワードなしで)作成し、組織に追加します。登録に招待が必要な場合も同じです。そのアドレスのアカウントがすでにある場合は、シングルサインオンがそのアカウントに関連付けられ、所有者にメールが届きます。

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

シングルサインオンが動作したら、確認済みドメインのメンバーにシングルサインオンを必須にするにチェックを付けます。

  • その後、管理対象のメンバーは ID プロバイダーを通じてのみサインインします。パスワード、パスキー、Google、Microsoft でのサインインには、組織がシングルサインオンを必須にしている旨と、そちらに進むボタンが表示されます。他のサインイン方法による現在のセッションはすぐに終了します。
  • 組織管理者には必須ではありません:組織管理者は 2 段階サインイン付きのパスワードまたはパスキーを使い続けるため、壊れた ID プロバイダーの設定を修正できます(緊急アクセス)。少なくとも 2 人の組織管理者を置いてください。
  • アドレスが確認済みドメインの外にあるメンバー(外部の共同作業者)は影響を受けません。
  • パスワードのリセットでは新しいパスワードが設定されますが、メンバーはサインインされません。その後、ID プロバイダーを通じてサインインします。
  • 管理対象のメンバーの API トークンと接続済みアプリは引き続き動作します。終了させるには、SCIM でアカウントを無効化します。

SCIM でアカウントをプロビジョニング

  1. プロビジョニング(SCIM 2.0)で、SCIM トークンを作成を選択し、パスワードを入力します。
  2. トークンとベース URL(https://app.holarch.app/scim/v2)を ID プロバイダーのプロビジョニング設定にコピーします。Holarch がトークンを表示するのは 1 回だけです。
  3. プロバイダーで、ユーザーの作成、更新、無効化をオンにします。

1 つの組織につき最大 5 トークンです。失効でトークンをすぐに終了します。

ID プロバイダーの証明書が変わるとき

  1. 古い証明書の下に新しい証明書を貼り付け(証明書は 2 つまで可)、保存します。
  2. プロバイダーを新しい証明書に切り替えます。
  3. 古い証明書を除去し、もう一度保存します。

証明書の一覧には、各証明書のサブジェクト、有効期限、フィンガープリントが表示されます。

複数の組織のための会社のサインイン(セルフホスト型)

1 つのメールドメインは 1 つの組織に属します。会社がセルフホスト型サーバーで部門ごとに 1 つの組織を運用する場合、1 つの組織(通常は IT 部門の組織)が会社のドメインを確認し、ID プロバイダーを接続して、シングルサインオンをオンにします。他の組織は、ID プロバイダーのグループを自身のロールに対応付けます:

  1. 部門の組織設定 → アクセスとサインイン → シングルサインオンで、会社のサインインを探します。そこに、会社のサインインを運用している組織の名前が表示されます。
  2. グループとロールに、1 行に 1 つずつ対応付けを書きます(例:packs-engineers = member、packs-leads = admin)。そしてグループを保存を選択します。
  3. 任意:カンマの後にグループの部門プロジェクトへのアクセスを追加します(例:packs-contractors = member, viewer)。部門プロジェクトへのアクセスを参照してください。

会社のサインインを通じてサインインするたびに、対応付けられたグループのユーザーは、そのロールでその組織に参加するか、そこで組織管理者になります。サインインによってユーザーが除去されたりロールが下がったりすることはありません(SCIM グループでは起こりえます:SCIM グループと部門を参照)。ユーザーの除去は組織管理者が組織設定で行います。ID プロバイダーはグループを送信する必要があります(会社のサインインのグループ属性)。

会社のサインインを運用する組織の組織管理者は、そのドメインのすべてのアドレスのサインインを管理します。その組織のメンバーは、ID プロバイダーを運用するユーザーだけにしてください。

部門プロジェクトへのアクセス(セルフホスト型)

各グループの対応付けでは、組織全体と共有されたプロジェクト(共有 → 組織)でそのグループのユーザーが持つ権限も指定できます:viewer、reviewer、または editor(既定)。そのようなプロジェクトでのユーザーのロールは、共有のロールと、そのユーザーの対応付けられたグループのうちそこで最も高いアクセスの、低いほうになります。たとえば、編集者として共有されたプロジェクトで packs-contractors = member, viewer の場合、外部委託先のユーザーはプロジェクトを閲覧します。packs-contractors と packs-engineers = member の両方に属するユーザーは編集します。このルールは、グループの出どころ(会社のシングルサインオン、SCIM グループ、会社ディレクトリ)にかかわらず適用されます。ユーザーと直接共有されたプロジェクトは影響を受けず、手動で追加された(対応付けられたグループに属さない)メンバーには共有のロールが与えられます。グループのアクセスを変更すると、そのグループによって配置された全員にすぐに適用されます。

編集者シート。ライセンスは編集者の数を制限します。閲覧者とレビュー担当者は無料です。グループの編集者アクセスによってユーザーが編集者になるはずのときに空きシートがない場合、そのユーザーは代わりに閲覧者になり、サインインはそのまま行えます。組織設定と管理者 → 会社ディレクトリには、閲覧者にとどめられている人数が表示されます。会社ディレクトリのページには、シートがグループによるものであるすべての編集者と、とどめられている各ユーザーが一覧表示されます。シートが空くと、とどめられていたユーザーは次の確認時に、メンバーになった順に編集者になります。

閉じたネットワーク上のサーバー。サーバーが公開 DNS を検索できない場合、サイト管理者は TXT レコードを公開する代わりに、未確認のドメインの横で確認済みにするを選択できます。そのドメインは引き続き 1 つの組織だけに属し、変更は監査ログに記録されます。

サインインのルール

Holarch は ID プロバイダーからのすべての応答を厳密にチェックします。次の場合、サインインは拒否されます。

  • アサーションが設定済みの証明書で署名されていないか、SHA-1 で署名されている。
  • 発行者、オーディエンス(組織のエンティティ ID)、宛先、または受信者(ACS URL)が一致しない。
  • アサーションがまだ有効でないか、期限切れである(2 分の時刻のずれは許容)。
  • 同じブラウザーで開始されていないサインイン、またはすでに使われたサインインへの応答である(各サインインは 1 回だけ開始され、10 分後に期限切れになります)。
  • 同じアサーションが 2 回目に届いた(リプレイ)。
  • メールアドレスがないか、組織の確認済みドメインの外にある。
  • アカウントが無効になっている。

その場合、サインイン画面に何が問題だったかが表示され、組織の監査ログに auth.sso-failed として記録されます。

ID プロバイダーのポータルからのサインイン(IdP-initiated。メンバーがプロバイダーのアプリダッシュボードから開始する場合)は、既定でオフです。そのような応答は、ブラウザーが開始したサインインに結び付いていないためです。メンバーに必要な場合にだけ、ID プロバイダーのポータルからのサインインを許可をオンにしてください。リプレイ保護とその他すべてのチェックは引き続き適用されます。

2 段階サインイン

既定では、シングルサインオンは第 1 段階です。2 段階サインインがオンのアカウントは引き続きパスキーまたはコードで確認し、組織の2 段階サインインを必須にする設定も引き続きメンバーにそれを求めます。

ID プロバイダーの多要素サインインを信頼がオンの場合、アサーションが多要素認証を報告するサインインでは Holarch の第 2 段階が不要になり、そのセッションについてこの組織の 2 段階の要件を満たします(他の組織の要件は満たしません)。Holarch は次の認証コンテキストを多要素として受け入れます。

認証コンテキスト送信元
https://refeds.org/profile/mfaそのように設定された多くのプロバイダー
http://schemas.microsoft.com/claims/multipleauthnMicrosoft Entra ID
urn:oasis:names:tc:SAML:2.0:ac:classes:MobileTwoFactorContract(および …MobileTwoFactorUnregistered)Okta など
urn:oasis:names:tc:SAML:2.0:ac:classes:TimeSyncTokenワンタイムコード
urn:oasis:names:tc:SAML:2.0:ac:classes:Smartcard と …SmartcardPKIスマートカード

Entra ID の http://schemas.microsoft.com/claims/authnmethodsreferences クレームに multipleauthn がある場合も数えます。ID プロバイダーでパスワードだけを使ったサインインは、信頼がオンでも多要素ではありません。

属性

Holarch既定の属性名(最初に見つかったものを使用)
メール(必須)email、mail、emailaddress、http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress、urn:oid:0.9.2342.19200300.100.1.3、NameID がメールアドレスの場合はその NameID、それ以外の場合は UPN クレーム(http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn)
名前displayName、name、http://schemas.microsoft.com/identity/claims/displayname、WS-Federation の name クレーム、または名と姓(givenName/firstName、sn/surname/lastName とそのクレーム形式)
グループグループ属性で指定した属性(例:groups)。指定がない場合:groups、memberOf、Role、AD FS の http://schemas.xmlsoap.org/claims/Group、http://schemas.microsoft.com/ws/2008/06/identity/claims/role、…/claims/groupsid、…/claims/groups

アカウントは ID プロバイダーの NameID(永続形式、メール形式、Windows ドメイン修飾名、またはその他の形式)で検索されます。NameID がない場合(AD FS は、要求規則で発行しない限り NameID を送信しません)、メールアドレスでアカウントを特定します。NameID が変わってもメールアドレスが同じであれば、アカウントは関連付け直されます。

グループ名は大文字と小文字を区別せずに比較されます。CORP\Packs Engineers のようなドメイン修飾名は Packs Engineers の対応付けにも一致し、グループの SID(S-1-5-21-…)はその SID で書かれた対応付けに一致します。

グループとロールの対応

1 行に 1 つの対応を書きます:holarch-admins = admin または engineering = member。サインインのたびに、admin に対応付けられたグループのメンバーは組織管理者になり、それ以外の対応付けられたグループのメンバーはメンバーになります。どの対応付けられたグループにも属さないメンバーは、ロールがそのままです。最後の組織管理者が降格されることはありません。

SCIM

SCIM API は RFC 7643 と RFC 7644 に従い、https://app.holarch.app/scim/v2 で Authorization: Bearer hsc_… を使います。

エンドポイント機能
GET /ServiceProviderConfig, /ResourceTypes, /Schemasサービスを記述
GET /Users組織のプロビジョニング済みユーザーと、確認済みドメインのメンバーを一覧表示します。filter は userName、externalId、id、emails.value、emails[type eq "work"].value に対する eq。startIndex と count
POST /Usersユーザーを作成し(またはそのアドレスの既存アカウントを関連付け)、組織に追加します
GET, PUT, PATCH /Users/<id>ユーザーの読み取り、置き換え、変更:userName、name、displayName、emails、externalId、active
DELETE /Users/<id>ユーザーを無効化し、外部 ID を破棄します
/Groupsセルフホスト型サーバー:グループの一覧表示、作成、読み取り、置き換え、変更(members、displayName、externalId に対する PATCH。Okta と Microsoft Entra ID の形式)、削除。displayName、externalId、id に対する eq による filter。excludedAttributes=members。SCIM グループと部門を参照してください。ホスト型サービス:空の一覧を返し、変更は拒否されます。代わりにシングルサインオンでグループをロールに対応付けてください。
  • 作成・変更できるのは、組織の確認済みドメインのアドレスだけです。
  • 無効化(active: false または DELETE)は、その人を組織から除去し、アカウントを無効にし、すべてのセッションを終了し、API トークンと接続済みアプリを失効させます。再有効化するとアカウントが有効になり、組織のロールが戻ります。Holarch が(不正利用などのために)無効にしたアカウントは無効のままです。
  • Enterprise 拡張属性は受け付けられますが、無視されます。
  • 各トークンは 1 分間に 600 リクエストまで送れます。すべての変更は組織の監査ログに記録されます(scim.create、scim.deactivate など)。

SCIM グループと部門(セルフホスト型)

セルフホスト型サーバーでは、ID プロバイダーは会社のドメインを持つ組織の SCIM エンドポイントにグループを送信できます。その後、会社のサインインにある各部門のグループとロールによって、誰がどの部門にどのロールで所属するかが決まります。1 つの対応付けが、会社のシングルサインオンによるサインインと SCIM グループの両方に使われます。

  • 対応付けられたグループに追加されたユーザーは、対応付けられたロールでその組織に参加します。グループが変わるとロールも変わります。
  • 対応付けられたすべてのグループから外されたユーザーは、グループによって追加された組織から外れます。
  • 他の方法(組織管理者、招待、インポート、サインイン)で追加されたメンバーシップが、グループによって除去されたり下げられたりすることはありません。グループにできるのは組織管理者に引き上げることだけです。組織管理者がメンバーのロールを手動で変更すると、それ以降、そのメンバーシップは組織管理者の管理になります。
  • 組織の最後の組織管理者が除去されたり下げられたりすることはありません。
  • 部門のグループとロールを変更すると、グループ内の全員にすぐに適用されます。
  • グループのメンバーは、このトークンがプロビジョニングまたは管理するユーザーである必要があります。それ以外の ID は無視されます。
  • ユーザーの無効化は従来どおりに動作します。所属する部門はグループに従います。
  • すべての変更が記録されます:会社の組織の監査ログには scim.group-create、scim.group-update、scim.group-delete が、部門のログには各メンバーシップの変更が記録されます。

ID プロバイダーを設定

Okta

  1. Applications → Create App Integration → SAML 2.0。
  2. Single sign-on URL:ACS URL。Use this for Recipient URL and Destination URL はチェックを付けたままにします。Audience URI (SP Entity ID):エンティティ ID。
  3. Name ID format:EmailAddress または Persistent。Application username:Email。
  4. Attribute statements:email → user.email、displayName → user.displayName。Group attribute statements(任意):groups。必要に応じてフィルターを設定します。
  5. 完了したら、Sign On タブの Metadata URL を Holarch にコピーし、メタデータを読み取るを選択します。
  6. SCIM の場合:アプリの General タブで SCIM provisioning を有効にします。Provisioning で、SCIM connector base URL はベース URL、Unique identifier field は userName、Authentication Mode は SCIM トークンを使う HTTP Header です。Create Users、Update User Attributes、Deactivate Users を有効にします。

Microsoft Entra ID

  1. Enterprise applications → New application → Create your own application(ギャラリー以外)を選び、Single sign-on → SAML を選択します。
  2. Identifier (Entity ID):エンティティ ID。Reply URL (Assertion Consumer Service URL):ACS URL。
  3. Attributes & Claims:既定の emailaddress クレームが使えます。グループを対応付ける場合は、グループクレームを追加します。
  4. SAML Certificates で、App Federation Metadata Url を Holarch にコピーし、メタデータを読み取るを選択します。
  5. Entra の多要素サインインを信頼するには、アプリの条件付きアクセスポリシーで MFA を必須にします。すると Entra が multipleauthn を送信します。
  6. SCIM の場合:Provisioning → Automatic。Tenant URL はベース URL、Secret Token は SCIM トークンです。Test Connection を行ってから、プロビジョニングを開始します。

Microsoft AD FS

AD FS(Active Directory Federation Services、Windows Server 2016 以降)は、オンプレミスの Active Directory のユーザーをサインインさせます。AD FS Management コンソールで:

  1. Relying Party Trusts → Add Relying Party Trust → Claims aware → Import data about the relying party published online を選び、Holarch のメタデータ URL を入力します。AD FS サーバーが Holarch に到達できない場合は、メタデータをファイルとして保存し、Import data about the relying party from a file を選択します。表示名:Holarch。
  2. Access control policy:Permit everyone、または Permit everyone and require MFA(手順 6 を参照)。
  3. 信頼の Edit Claim Issuance Policy → Add Rule → Send LDAP Attributes as Claims を開き、属性ストアに Active Directory を指定します:
LDAP 属性出力方向の要求の種類
E-Mail-AddressesE-Mail Address
Display-Name名前
Token-Groups – Unqualified Namesグループ

2 つのドメインに同じ名前のグループがある場合は、代わりに Token-Groups – Qualified by Domain Name を使用します。グループ名が変わる場合は Token-Groups as SIDs(要求の種類 Group SID)を使用します。Holarch は、グループ属性がなくても Group、Role、Group SID の要求を読み取ります。

AD FS は、各グループの表示名や cn ではなく、pre-Windows 2000 name(sAMAccountName)を送信し、プライマリグループ(通常は Domain Users)も含めます。グループはその名前、または SID で対応付けてください。会社ディレクトリが接続されたサーバーでは、管理者 → 会社ディレクトリ → ユーザーをテストで、ユーザーの各グループについて両方が一覧表示されます。

  1. 任意、安定した NameID:Add Rule → Transform an Incoming Claim で、入力方向に E-Mail Address(または UPN)、出力方向に Name ID、形式に Email(または Persistent Identifier)を指定します。これがない場合、Holarch はメールアドレスでアカウントを特定します。
  2. 信頼の Properties → Advanced で SHA-256 のままにします。Encryption タブは空のままにしてください。Holarch はアサーションを復号せず、接続は https です。AD FS は既定でアサーションに署名します(SamlResponseSignature AssertionOnly)。Holarch ではこの署名が必須です。
  3. https://<your AD FS host>/FederationMetadata/2007-06/FederationMetadata.xml を Holarch のメタデータ URL にコピーし、メタデータを読み取るを選択します。エンティティ ID(http://<host>/adfs/services/trust)、サインイン URL(https://<host>/adfs/ls/)、トークン署名証明書が入力されます。AD FS の多要素サインインを信頼するには、アクセス制御ポリシーで MFA を必須にし、ID プロバイダーの多要素サインインを信頼をオンにします。すると AD FS が http://schemas.microsoft.com/claims/multipleauthn を送信します。

セルフホスト型サーバーでは、メタデータ URL に内部アドレス(https://adfs.corp.example.com/…、プライベート IP)を使用でき、その証明書はシステムの信頼された CA に加えて tls/ldap-ca.pem の会社の CA でも確認されます。AD FS のトークン署名証明書は毎年更新されます。Holarch には有効期限が表示されるので、AD FS が新しい証明書を追加したらメタデータを読み取るを再度実行してください(重複期間中は両方が保持されます)。AD FS には SCIM がありません。セルフホスト型サーバーで会社ディレクトリを使う場合は、Holarch が自らアカウントを確認します(下記)。

Google Workspace

  1. Admin console → Apps → Web and mobile apps → Add app → Add custom SAML app。
  2. IdP metadata をコピーします(ダウンロードしてから、XML を Holarch に貼り付けます)。
  3. ACS URL:ACS URL。Entity ID:エンティティ ID。Name ID format:EMAIL、Name ID:Basic Information › Primary email。
  4. Attribute mapping:Primary email → email、First name → givenName、Last name → sn。Group membership → groups(任意)。
  5. アプリを ON for everyone(または組織部門に対してオン)にします。
  6. Google Workspace は MFA の認証コンテキストを送信しません。ID プロバイダーの多要素サインインを信頼はオフのままにしてください。Google の SCIM プロビジョニングはギャラリーアプリでのみ動作します。代わりにシングルサインオンでアカウントを作成してください。

Ping Identity

  1. PingOne: Applications → Add Application → SAML Application(PingFederate:SP 接続)。
  2. Holarch の Metadata URL をインポートするか、ACS URL と Entity ID を入力します。
  3. Attribute mapping:saml_subject → Email Address。email と displayName を追加します。
  4. IdP のメタデータ URL を Holarch にコピーし、メタデータを読み取るを選択します。
  5. SCIM の場合:SCIM 接続を使う PingOne のプロビジョニング。ベース URL と、SCIM トークンによる OAuth 2 Bearer Token 認証です。

会社ディレクトリ(Active Directory / LDAP)

セルフホスト型サーバーでは、ユーザーは会社のユーザー名とパスワードでサインインでき、会社のディレクトリがそれを確認します。ディレクトリは Active Directory(そのドメイン コントローラー)か、OpenLDAP や FreeIPA などの他の LDAP ディレクトリです。ID プロバイダーは不要です。サイト管理者が管理者 → 会社ディレクトリで設定します。サーバーの .env で初期値を指定することもできます(HOLARCH_LDAP_*、セルフホスト版の配布物の SIGN-IN.md)。ホスト型サービスでは提供されません。

会社ディレクトリを設定

まず、管理者 → 会社ディレクトリの上部でディレクトリの種類を選びます。Active Directory またはその他の LDAP ディレクトリ(OpenLDAP、FreeIPA、…)です。どちらの場合も接続は 1 つです。種類によって、提供されるグループの参照方法、Active Directory の既定値を使用または LDAP の既定値を使用がフォームに入れる値、ヒントと例が決まります。種類を変更すると、もう一方の種類の既定値のままのユーザー フィルターやグループの参照方法は置き換えられ、自分で書いたフィルターは維持されます。ページは保存された設定から種類を判断します(ネストされたグループまたは Active Directory のフィルターがあれば Active Directory です)。

  1. ディレクトリに読み取り専用のサービスアカウントを作成します(例:svc-holarch)。その名前をバインド アカウントに、パスワードをサーバーの .env に HOLARCH_LDAP_BIND_PASSWORD として入れ、サーバーを再起動します。パスワードが管理者ページに表示されることはありません。
  2. ディレクトリ サーバーに、各ドメイン コントローラーまたは LDAP サーバーを ldaps://dc1.corp.example.com(ポート 636)の形式で 1 行に 1 つずつ入力します。上から順に試行されます。ldap://host:389 は StartTLS を使用がオンの場合にのみ動作します。暗号化されていない LDAP は拒否されるため、パスワードが暗号化されずにネットワークを通ることはありません。各サーバーのホスト名は、証明書に記載されているとおりに使用してください。
  3. サーバーの証明書を発行した CA の証明書を、CA 証明書(PEM)に入れるか、サーバーの tls/ldap-ca.pem に置きます。空欄の場合はシステムの信頼された CA を使用します。
  4. ベース DN(DC=corp,DC=example,DC=com、他の LDAP ディレクトリでは dc=example,dc=com)と許可するメール ドメインを入力します。
  5. 接続をテストを選択します。フォームの値で保存せずに接続し、失敗した場合は問題(応答したサーバーがない、証明書、バインド アカウント、ベース DN)を示します。
  6. ユーザーをテストにユーザー名を入力すると、サインイン時に見つかる内容が表示されます:メールアドレス、アカウントが有効かどうか、グループ、参加することになる組織。パスワードは任意で、1 回だけ確認され、保存されることはありません。
  7. 会社アカウントでのサインインを許可をオンにして保存を選択します。サインイン画面に会社アカウントでサインイン(または設定したボタンのテキスト)が表示されるようになります。

Active Directory:既定のユーザー フィルターは、有効なユーザーを sAMAccountName、userPrincipalName、mail で検索するため、ユーザーは jsmith、[email protected]、CORP\jsmith のいずれかを入力できます。無効なアカウントは除外されます。グループの参照方法には Active Directory(ネストされたグループを含む)(既定)と memberOf 属性(直接のグループのみ)があります。

その他の LDAP ディレクトリ:LDAP の既定値を使用は (&(objectClass=inetOrgPerson)(|(uid={username})(mail={username}))) をユーザー フィルターに入れるため、ユーザーは自分の uid またはメールアドレスを入力します。入力された名前の位置に {username} を置けば、どのフィルターでも使えます。グループの参照方法には memberOf 属性(memberof オーバーレイを使う OpenLDAP、FreeIPA、389 Directory Server)とユーザーをメンバーとして持つグループ(groupOfNames と groupOfUniqueNames。場所はグループのベース DN で指定します)があります。ネストされたグループは数えられません。

ディレクトリのグループから部門へ

ディレクトリのグループは、SAML と同じ会社のサインインのグループとロールの対応でユーザーを組織に配置します(複数の組織のための会社のサインインを参照)。各組織のシングルサインオンのボックスで、グループをロールに対応付けます(例:Packs Engineers = member、Packs Leads = admin)。名前は大文字と小文字を区別せずに比較されます。グループの DN も使え、Active Directory では SID も使えます。Active Directory(ネストされたグループを含む)では、グループ内の他のグループを通じて所属するユーザーもそのグループに数えられます。

サインインのたびと定期確認のたびに、対応付けられたグループのユーザーは、そのロールと、グループの部門プロジェクトへのアクセスで、その組織に参加します。ディレクトリによって与えられたメンバーシップは、そのユーザーがそれに対応するすべてのグループから外れると除去されます。手動で追加されたメンバーシップは残ります(ディレクトリはそこでメンバーを組織管理者に引き上げることはできますが、下げることはありません)。最後の組織管理者が除去されることはありません。

サインインできるユーザー

  • アカウントはディレクトリで有効である必要があります。無効化、ロックアウト、期限切れのアカウントは拒否され、パスワードの有効期限が切れたアカウントや、次回ログオン時にパスワードの変更が必要なアカウントも拒否されます。
  • ディレクトリのエントリには、許可されたドメインのメールアドレスが必要です。最初のサインインで Holarch アカウントが作成されるか、そのアドレスを持つ既存のアカウントがリンクされます。すでに別のディレクトリ エントリにリンクされているアカウントが乗っ取られることはありません。
  • リンク済みアカウントに会社アカウントでのサインインを必須にするを使うと、リンク済みのアカウントは Holarch のパスワードでサインインできなくなります。サイト管理者はパスワードを保持するため、ディレクトリが停止しても全員が締め出されることはありません。
  • パスワードの誤りが一時停止までの失敗回数(既定 3)に達すると、その会社アカウントのサインインは 15 分間一時停止されます。どの形式の名前(jsmith、[email protected]、CORP\jsmith)で入力したかは関係ありません。Holarch が会社アカウントをロックしないよう、この値はドメインのロックアウトのしきい値より小さくしてください。不明なユーザー名と誤ったパスワードには、同じ応答がほぼ同じ時間で返されます。

定期確認

アカウントの確認間隔(既定 15 分)ごとに、サーバーは、サインイン中またはディレクトリによるメンバーシップを持つリンク済みアカウントをそれぞれ検索します。無効化された、ロックアウトされた、ディレクトリから削除された、またはパスワードの有効期限が切れたか次回ログオン時に変更が必要な(多くの場合、侵害が疑われた後の管理者によるリセット)ユーザーは、すべての場所でサインアウトされ、ディレクトリによって与えられたメンバーシップを失います。グループの変更はメンバーシップに反映されます。ロックアウトされたアカウントは、ロック解除後の次のサインインでメンバーシップを取り戻します。ディレクトリに到達できない場合は何も変わりません。確認したアカウントの大半が見つからない場合(たとえばベース DN の誤りの後)、何も終了されず、管理者ページに警告が表示されます。今すぐ確認で確認をすぐに実行します。管理者ページには前回の確認の結果が表示されます。

各確認では、対応付けられたすべてのグループのメンバーも検索し(Active Directory(ネストされたグループを含む)ではネストされたグループも数えます)、まだアカウントを持たないユーザーのアカウントを、サインインと同じルール(有効であること、許可されたメールドメイン、他でリンクされたアカウントを乗っ取らないこと)で用意します。メールは送信されません。ユーザーは初めて Holarch が必要になったときに会社アカウントでサインインし、その時点ですでに自分の部門に所属しているため、それより前にプロジェクトを共有しておけます。1 回の確認で用意されるアカウントは最大 200 件で、次の確認を待っている件数が管理者ページに表示されます。SID だけで指定されたグループはこの方法では検索されず、そのユーザーはサインイン時に配置されます。

会社ディレクトリでの 2 段階サインイン

会社のサインインは1 段階目です。2 段階サインインを必須にしている組織では引き続き Holarch の 2 段階目(パスキーまたはコード)が求められ、2 段階サインインをオンにしているアカウントも引き続きそれを確認します。会社アカウントでのサインインを 2 段階サインインとして扱うは、会社アカウント自体に 2 つ目の要素が必要な場合にのみオンにしてください。オンにすると、そのセッションではすべての組織の 2 段階サインインの要件を満たします。

ディレクトリでのサインイン、拒否、設定の変更はすべて、監査ログ(admin.directory-save、admin.directory-test、directory.account-ended)と各アカウントのサインイン記録に残ります。パスワードが記録されることはありません。

上限とセキュリティに関する注記

制限:シングルサインオンは、ID プロバイダーへの HTTP-Redirect バインディングと、Holarch への HTTP-POST による戻りを使用します。署名付きおよび暗号化された認証要求、暗号化されたアサーション、シングルログアウトはサポートされていません。SCIM グループはセルフホスト型サーバーでのみサポートされます(SCIM グループと部門)。会社ディレクトリはユーザー名とパスワード(TLS 上の単純バインド)でサインインします。Kerberos と Windows 統合サインインはサポートされていません。

  • 設定の変更には最近のパスワード確認が必要で、すべての組織管理者にメールで通知され、監査ログに記録されます(sso.saml-save、sso.enable、sso.require、sso.domain-verify、scim.token-create…)。
  • メタデータ URL は、公開インターネット上では https を使う必要があります(セルフホスト型サーバーでは内部アドレスも使用できます)。Holarch は、メタデータを読み取るを選択したときに 1 回だけ取得します。
  • SCIM トークンはハッシュとしてのみ保存されます。