ownCloud Infinite ScaleをLDAPに接続してユーザーサインインを行う

ownCloud Infinite Scale (oCIS) で既存の LDAP ディレクトリを使用するには、組み込みの OpenID Connect ID プロバイダ (IDP) を設定して、LDAP に対してユーザー認証を行うようにし、ユーザー、グループ、および認証サービスを同じディレクトリに向けます。LDAP は、従来のサーバー管理ウィザードでは設定できません。具体的な設定は、oCIS のリリースとディレクトリ スキーマによって異なります。このリファレンスでは、ownCloud 8.2 のサービス ドキュメントと Docker Compose スタイルの環境変数を使用します。

oCISにおける「LDAP認証」の意味を理解する

oCIS は、ブラウザのサインインと、ユーザーやグループを検索するサービスを分離します。組み込みの IDP は、LDAP を使用してユーザー認証を行い、OIDC トークンを発行できます。Graph や Users などのサービスも、ID を解決するために、一致する LDAP 接続と属性設定が必要です。Auth Basic サービスは、HTTP Basic 認証を必要とするクライアントに対して処理を行います。これは別のパスです。アクション:設定を変更する前に、ブラウザログイン、特定のクライアントに対する Basic 認証、またはその両方が必要かどうかを決定してください。

ownCloud 8.2 のドキュメントでは、小規模環境向けに組み込みの IDP と IDM について説明していますが、エンタープライズ規模の展開にはエンタープライズグレードの外部 ID プロバイダーを推奨しています。Keycloak や Active Directory Federation Services などの OIDC プロバイダーを既に利用している場合は、LDAP を直接ログイン認証局として使用するよりも、そのプロバイダーを統合する方が適している可能性があります。対策:展開前に、関連する ownCloud 展開ガイドを参照して、アーキテクチャとサポートされているリリースを確認してください。

まずディレクトリの詳細情報を収集します

LDAP管理者に、サーバーのホスト名とポート番号、TLS証明書チェーン、バインドアカウントのDNとパスワード、ユーザー検索ベース、ログイン属性、一意のユーザーID属性、メールアドレスと表示名属性、ユーザーオブジェクトクラス、および必要なユーザーフィルタを問い合わせてください。グループをoCISに表示する必要がある場合は、グループベースDN、オブジェクトクラス、名前属性、メンバーシップ属性、および安定グループID属性も収集してください。

  • 検索には、専用の最小権限バインドアカウントを使用してください。
  • ディレクトリポリシーに従って、LDAPとStartTLSを優先的に使用しldaps://、発行元のCA証明書をoCISコンテナが読み取れる場所にインストールしてください。
  • 安定した一意のユーザー識別子を選択してください。ユーザーがインスタンスの使用を開始した後で、安易にID属性を変更しないでください。
  • oCISホストまたはコンテナがLDAPサーバーを解決してアクセスできること、およびファイアウォールルールで選択したLDAP TLSポートが許可されていることを確認してください。

スキーマ名は、OpenLDAP、Active Directory、カスタムディレクトリによって異なります。ownCloudのサンプルデフォルト値(例:inetOrgPerson、、uidなど)はownCloudUUID普遍的なものではありません。対策:本番環境に移行する前に、各属性を実際のディレクトリエントリと照合し、代表的なテストアカウントを使用してください。

内蔵IDPを設定する

Docker Composeの場合、環境変数はocisサービスに設定されます。以下はテンプレートであり、そのまま使用できる設定ではありません。例の値を実際のディレクトリの設定に置き換え、CAファイルを指定されたパスにコンテナにマウントしてください。

services:
  ocis:
    environment:
      IDP_LDAP_URI: ldaps://ldap.example.org:636
      IDP_LDAP_TLS_CACERT: /etc/ocis/ldap-ca.pem
      IDP_LDAP_BIND_DN: cn=ocis-reader,ou=service-accounts,dc=example,dc=org
      IDP_LDAP_BIND_PASSWORD: ${OCIS_LDAP_BIND_PASSWORD}
      IDP_LDAP_BASE_DN: ou=people,dc=example,dc=org
      IDP_LDAP_LOGIN_ATTRIBUTE: uid
      IDP_LDAP_OBJECTCLASS: inetOrgPerson
      IDP_LDAP_UUID_ATTRIBUTE: entryUUID
      IDP_LDAP_EMAIL_ATTRIBUTE: mail
      IDP_LDAP_NAME_ATTRIBUTE: displayName
      IDP_USER_ENABLED_ATTRIBUTE: ownCloudUserEnabled

上記の設定は、IDP側のLDAPルックアップとログインに関するものです。パスワードは環境置換として表示されるため、Composeファイルにハードコーディングする必要はありませんが、環境ファイルを保護するか、デプロイメントプラットフォームのシークレット機能を使用してください。CAパスはホスト上だけでなく、コンテナ内にも存在する必要があります。対処方法: CAを読み取り専用でマウントし、コンテナユーザーが読み取り可能であることを確認してから、oCISを再起動してください。

実際に使用している有効/無効属性とその値を使用してください。ドキュメントIDP_USER_ENABLED_ATTRIBUTEでは、チェック対象の属性として名前が記載されています。「有効」の意味は、スキーマと実装によって異なります。この設定がディレクトリで使用されていない場合は、値を勝手に作成しないでください。正確なリリースについては、サービスドキュメントを参照してください。アクション:有効なアカウントと無効なアカウントの両方をテストして、アクセス ポリシーを確認します。

ID検索と認証を連携させる

IDP 設定のみを変更すると、oCIS の他の部分で同じユーザーまたはグループを解決できない場合でも、資格情報の確認は可能になる場合があります。Users サービスにはUSERS_LDAP_URI、、、、、、などの独自の LDAP 変数があります。Graph は対応するオプションを使用し、ユーザーとグループのクエリを制御します。これらのサービスがデプロイメントの一部である場合はUSERS_LDAP_CACERT、これらを同じディレクトリと互換性のあるスキーマに設定してください。USERS_LDAP_BIND_DNUSERS_LDAP_BIND_PASSWORDUSERS_LDAP_USER_BASE_DNGRAPH_LDAP_*

例えば、IDP と Graph 間でユーザー ベース DN と安定 ID 属性を一致させ、次に Graph のグループ ベース DN とメンバー属性を LDAP レコードと一致するように設定します。Graph サービスのドキュメントには、LDAP バックエンドがデフォルトであり、サーバー書き込み設定が個別に識別されていると記載されています。アクション:ディレクトリが他の場所で権限を持っている場合は、読み取り専用のルックアップから開始します。oCISがディレクトリのユーザーとグループを作成または変更してはならない場合GRAPH_LDAP_SERVER_WRITE_ENABLEDに設定します。false

AUTH_BASIC_AUTH_PROVIDER=ldapクライアントが実際に HTTP 基本認証を必要とする場合にのみ設定してください。ownCloud のドキュメントには、基本認証はプロキシでも有効にする必要があると記載されてPROXY_ENABLE_BASIC_AUTH=trueいます。これは通常の OIDC ブラウザサインインの代替ではありません。対処方法:特定のクライアントが必要とする場合を除き、基本認証は無効のままにしておき、有効にする前にセキュリティ上の影響を確認してください。

再起動、テスト、トラブルシューティング

  1. Composeファイルを検証し、変数が正しいサービスに紐づいていることを確認してください。
  2. 通常のデプロイ手順に従ってoCISを再起動または再デプロイし、サービスが新しい値をロードするようにしてください。
  3. 起動ログとサービスログを確認し、LDAP接続、バインド、証明書、および検索エラーがないか確認してください。
  4. 既知のユーザーによるWebインターフェース経由でのログインをテストし、ユーザープロファイルと想定されるグループが正しく解決されることを確認します。
  5. 無効なパスワードと無効化されたユーザーでテストしてください。どちらもアクセスできないことを確認してください。

接続が失敗した場合は、コンテナ内から DNS とネットワークの到達可能性を確認し、LDAPS ホスト名が証明書と一致していること、CA チェーンが信頼されていること、バインド DN とパスワードが正しいことを確認してください。LDAP バインドが成功したとしても、ユーザー検索ベースやログイン属性が正しいとは限りません。サインインは機能するものの、ユーザーまたはグループデータが欠落している場合は、IDP、ユーザー、およびグラフの設定を比較し、それぞれのログを確認してください。対処方法: TLS 検証を緩めるのではなく、一度に 1 つのサービスと 1 つのテスト アカウントをテストして、障害を特定してください。

本番環境では、LDAP TLS検証バイパスオプションを設定しないでください。ownCloudは、安全でないLDAP証明書設定に対して明確な警告を発しています。ログインとグループ解決が検証されるまで、復旧用管理者アカウントと以前の正常に動作していた構成のコピーを保持してください。対策:まずステージング環境で変更を適用し、必要に応じて管理者が以前の環境を復元できる期間内に展開してください。

公式資料

コメントを残す

ownCloudをLet's EncryptとNginxを使ってHTTPSで運用する

ownCloudをLet's EncryptとNginxを使ってHTTPSで運用する

HTTP-01またはDNS-01を選択し、ownCloudリバースプロキシを設定して、CertbotがHTTPS証明書を自動的に更新することを確認してください。

ownCloud Infinite ScaleをLDAPに接続してユーザーサインインを行う

展開前に、oCIS LDAPサインインを設定し、ユーザーとグループのルックアップを整合させ、TLSとスキーマの設定を確認してください。

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にS3バケットを外部ストレージとして接続する

ownCloud 10にAmazon S3バケットを追加し、互換性のある認証情報とエンドポイントを準備し、マウントとプライマリストレージを混同することなくアクセスを確認します。

ownCloudデータベースのダンプを安全な夜間Cronジョブで自動化する

ownCloudデータベースのダンプを安全な夜間Cronジョブで自動化する

ownCloud Server の保護された MariaDB ダンプをスケジュールし、メンテナンスモードを安全に処理し、各バックアップに依存する前に検証します。

サポート対象の移行を使用してownCloud ClassicをoCISに移行する

ownCloud 10からoCISへの移行を計画する際は、サポート対象のアプリ、順序付けられたコマンド、本人確認、および個別に処理する必要のあるデータの明確なリストを用意してください。

テーマアプリとCSSを使用したブランドownCloud Classic 10

ownCloud Classic 10のロゴを置き換え、テーマアプリを使用してWeb UIの色を調整し、アップグレードや整合性チェックの落とし穴を回避します。

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

ownCloud oCISでユーザーロールごとにデフォルトのストレージクォータを設定する

役割ごとに、新しいownCloud Infinite Scaleユーザーにバイト単位のストレージ制限を割り当てます。proxy.yamlの例と安全な検証チェックリストも含まれています。

ownCloud同期証明書のTLSソースエラーを修正する

ownCloud同期証明書のTLSソースエラーを修正する

TLS検証を無効にせずに、サーバーのホスト名、証明書チェーン、プライベートCAの信頼、およびキャプティブポータルの問題を確認することで、ownCloudデスクトップの同期を復元します。

アップグレード後にownCloudの整合性警告をクリアする

無効ファイルレポートを使用して、一致しないコアファイルまたはアプリ署名を特定し、正しいリリースファイルを復元し、整合性チェックを安全に検証します。

ownCloud Infinite ScaleをDocker Composeでインストールする

ownCloud Infinite Scaleを公式のComposeサンプルからデプロイし、ドメインと永続ストレージを設定した後、TLS、コンテナ、および初回ログインを確認します。