始める前に
仕組み
- ユーザーは
https://console.clickhouse.cloudにアクセスし、メールアドレスを入力します (または、組織の直接リンクを使用します) 。 - ClickHouse Cloud は認証のため、ユーザーをアイデンティティプロバイダーにリダイレクトします。
- 認証が成功すると、アイデンティティプロバイダーはユーザーを ClickHouse Cloud にリダイレクトします。
- その後、ユーザーは ClickHouse Cloud にサインインし、初回ログイン時にアカウントがジャストインタイムでプロビジョニングされ、設定したデフォルトロールが割り当てられます。
IdP の設定方法
1
組織設定にアクセスする
左下にある組織名をクリックし、[Organization details] を選択します。
2
SAMLシングルサインオンを有効にする
Enable SAML single sign-on の横にあるトグルをクリックします。セットアップ中にこの画面を何度か参照するため、このまま開いておいてください。3
ID プロバイダーにアプリケーションを作成する
ID プロバイダー内にアプリケーションを作成し、
Enable SAML single sign-on 画面に表示される値を ID プロバイダーの設定にコピーしてください。この手順の詳細については、以下の該当する ID プロバイダーの説明を参照してください。4
メタデータURLをSAML設定に追加する
SAMLプロバイダから
Metadata URLを取得します。ClickHouse Cloudに戻り、Next: Provide metadata URLをクリックして、URLをテキストボックスに貼り付けます。5
ドメイン検証コードを取得する
Next: Verify your domains をクリックします。テキストボックスにドメインを入力し、Check domain をクリックします。DNS プロバイダで TXT レコードに追加するためのランダムな検証コードが生成されます。6
ドメインを確認する
DNSプロバイダーでTXTレコードを作成します。
TXT record name を、DNSプロバイダー側のTXTレコードのNameフィールドにコピーします。Value を、DNSプロバイダー側のContentフィールドにコピーします。Verify and Finish をクリックして、手順を完了します。DNSレコードの更新と確認が完了するまで、数分かかる場合があります。設定ページを離れても、最初からやり直すことなく、後で戻って手順を完了できます。検証値は、最初に生成されてから48時間有効です。
7
デフォルトのロールとセッションタイムアウトを更新
SAML の設定が完了したら、すべてのユーザーにログイン時に割り当てるデフォルトのロールを設定し、セッションタイムアウトも調整できます。割り当て可能なシステムロールの一覧については、Console のロールと権限を参照してください。
8
管理者ユーザーを設定する
別の認証方式で設定されたユーザーは、組織内の管理者が削除するまで保持されます。
- ClickHouse Cloud からログアウトします。
- ID プロバイダーで、管理者ユーザーを ClickHouse アプリケーションに割り当てます。
- ユーザーに https://console.clickhouse.cloud/?connection={orgId} (ショートカット URL) からログインしてもらいます。前の手順で作成したブックマークからアクセスしてもかまいません。ユーザーは初回ログインするまで ClickHouse Cloud に表示されません。
- デフォルトの SAML ロールが Admin 以外の場合は、新しい SAML ユーザーのロールを更新するために、いったんログアウトしてから元の認証方式で再度ログインする必要がある場合があります。
- メール + パスワードのアカウントの場合は、
https://console.clickhouse.cloud/?with=emailを使用してください。 - ソーシャルログインの場合は、該当するボタン (Continue with Google または Continue with Microsoft) をクリックしてください。
- メール + パスワードのアカウントの場合は、
上記の
?with=email にある email は、プレースホルダーではなく文字どおりのパラメーター値です- もう一度ログアウトし、以下の最後の手順を完了するためにショートカット URL から再度ログインします。
9
他の認証方式を削除する
インテグレーションを完了するには、SAML 以外の方式を使用しているユーザーをすべて削除し、アクセスを identity provider connection に由来するユーザーのみに制限します。
アイデンティティプロバイダーを設定する
- Okta
- Google
- Azure(Microsoft)
- Duo
Okta では、ClickHouse の各組織ごとに 2 つの App Integration を設定します。1 つは SAML アプリ、もう 1 つは 直接リンク を保持するためのブックマークです。
アクセス管理用のグループを作成する
- Administrator として Okta インスタンスにログインします。
- 左側で Groups を選択します。
- Add group をクリックします。
- グループの名前と説明を入力します。このグループは、SAML アプリと関連するブックマークアプリの間でユーザーを一致させるために使用します。
- Save をクリックします。
- 作成したグループ名をクリックします。
- Assign people をクリックし、この ClickHouse 組織へのアクセスを許可するユーザーを割り当てます。
ユーザーがシームレスにログインできるようにブックマークアプリを作成する
- 左側で Applications を選択し、次に Applications サブ見出しを選択します。
- Browse App Catalog をクリックします。
- Bookmark App を検索して選択します。
- Add integration をクリックします。
- アプリのラベルを選択します。
- URL に
https://console.clickhouse.cloud/?connection={organizationid}を入力します - Assignments タブに移動し、上で作成したグループを追加します。
接続を有効にするための SAML アプリを作成する
- 左側で Applications を選択し、次に Applications サブ見出しを選択します。
- Create App Integration をクリックします。
- SAML 2.0 を選択し、Next をクリックします。
- アプリケーション名を入力し、Don’t display application icon to users の横にあるチェックボックスをオンにしてから Next をクリックします。
-
次の値を使用して SAML 設定画面を入力します。
-
次の Attribute Statement を入力します。
- Next をクリックします。
- Feedback 画面で必要な情報を入力し、Finish をクリックします。
- Assignments タブに移動し、上で作成したグループを追加します。
- 新しいアプリの Sign On タブで、Copy metadata URL ボタンをクリックします。
- Add the metadata URL to your SAML configuration に戻り、手順を続けます。
トラブルシューティング
システムの設定ミス、またはサービス障害の可能性があります
システムの設定ミス、またはサービス障害の可能性があります
原因: サポートされていない identity-provider-initiated login を使用しています。対処: 直接リンク
https://console.clickhouse.cloud/?connection={organizationid} を使用してください。これをユーザーの既定のログイン方法にするには、上記の アイデンティティプロバイダー の手順に従って設定してください。アイデンティティプロバイダー に移動した後、ログインページに戻される
アイデンティティプロバイダー に移動した後、ログインページに戻される
原因: アイデンティティプロバイダー でメール属性のマッピングが設定されていません。対処: 上記の アイデンティティプロバイダー の手順に従ってユーザーのメール属性を設定し、再度ログインしてください。
ユーザーがこのアプリケーションに割り当てられていない
ユーザーがこのアプリケーションに割り当てられていない
原因: そのユーザーが アイデンティティプロバイダー 内の ClickHouse アプリケーションに割り当てられていません。対処: アイデンティティプロバイダー でそのユーザーをアプリケーションに割り当ててから、再度ログインしてください。
複数の SAML 組織がある場合でも、常に同じ組織に移動してしまう
複数の SAML 組織がある場合でも、常に同じ組織に移動してしまう
原因: 最初の組織にまだログインしたままです。対処: ログアウトしてから、別の組織にログインしてください。
URL に一時的に access denied と表示される
URL に一時的に access denied と表示される
原因: メールドメインが設定済みのドメインと一致していません。対処: このエラーの解決については、サポートにお問い合わせください。
よくある質問
ClickHouse Cloud は identity-provider-initiated サインインをサポートしていますか?
ClickHouse Cloud は identity-provider-initiated サインインをサポートしていますか?
いいえ。サービスプロバイダー開始型 フローのみに対応しています。ユーザーは
https://console.clickhouse.cloud にアクセスしてメールアドレスを入力し、アイデンティティプロバイダー にリダイレクトされます。ユーザーが URL を覚えなくて済むよう、ブックマークまたは直接リンク (https://console.clickhouse.cloud/?connection={organizationid}) を設定してください。複数の組織で SAML SSO を使うにはどうすればよいですか?
複数の組織で SAML SSO を使うにはどうすればよいですか?
ClickHouse Cloud は、組織ごとに個別の connection を設定することで、複数組織での SSO をサポートしています。各組織へのログインには直接リンク (
https://console.clickhouse.cloud/?connection={organizationid}) を使用し、別の組織にログインする前に現在の組織からログアウトしてください。ユーザーが https://console.clickhouse.cloud でメールアドレスを入力した際に、該当ドメインのユーザーを自動的に組織へ振り分けないようにしたい場合は、その動作を無効にするようサポートチケットを起票してください。同じユーザーに対して複数のアカウントが表示されるのはなぜですか?
同じユーザーに対して複数のアカウントが表示されるのはなぜですか?
ClickHouse Cloud では、SSO アカウントと非 SSO アカウントは自動的に関連付けられないため、両方の方法でサインインしたユーザーは、同じメールアドレスであってもユーザー一覧に複数回表示されることがあります。
次のステップ
- クラウドユーザーの管理 — ユーザー権限を管理し、アクセスを SAML 接続のみに制限します。
- SCIM provisioning — ユーザーとグループのプロビジョニングを自動化します (プライベートプレビュー) 。
- Console roles and permissions — デフォルトの SAML ロールとして割り当て可能なロールを確認できます。