始める前に
IdP での管理者権限、自身のドメインの DNS 設定に TXT レコードを追加する権限、そして ClickHouse Cloud 組織での Admin ロールが必要です。ログイン手順を簡略化するため、SAML 接続に加えて、組織への直接リンクを設定することをおすすめします。この設定方法は IdP ごとに異なります。お使いの IdP での設定方法については、このまま読み進めてください。仕組み
SAML SSO を設定すると、ユーザーはサービスプロバイダー開始型のフローでサインインします。- ユーザーは
https://console.clickhouse.cloudにアクセスし、メールアドレスを入力します (または、組織の直接リンクを使用します) 。 - ClickHouse Cloud は認証のため、ユーザーをアイデンティティプロバイダーにリダイレクトします。
- 認証が成功すると、アイデンティティプロバイダーはユーザーを ClickHouse Cloud にリダイレクトします。
- その後、ユーザーは ClickHouse Cloud にサインインし、初回ログイン時にアカウントがジャストインタイムでプロビジョニングされ、設定したデフォルトロールが割り当てられます。
IdP の設定方法
SAML がすでに有効になっていて管理者アクセスが必要な場合は、管理者ユーザーを設定するまたはトラブルシューティングを参照してください。SAMLシングルサインオンを有効にする
Enable SAML single sign-on の横にあるトグルをクリックします。セットアップ中にこの画面を何度か参照するため、このまま開いておいてください。ID プロバイダーにアプリケーションを作成する
ID プロバイダー内にアプリケーションを作成し、
Enable SAML single sign-on 画面に表示される値を ID プロバイダーの設定にコピーしてください。この手順の詳細については、以下の該当する ID プロバイダーの説明を参照してください。メタデータURLをSAML設定に追加する
SAMLプロバイダから
Metadata URLを取得します。ClickHouse Cloudに戻り、Next: Provide metadata URLをクリックして、URLをテキストボックスに貼り付けます。ドメイン検証コードを取得する
Next: Verify your domains をクリックします。テキストボックスにドメインを入力し、Check domain をクリックします。DNS プロバイダで TXT レコードに追加するためのランダムな検証コードが生成されます。ドメインを確認する
DNSプロバイダーでTXTレコードを作成します。
TXT record name を、DNSプロバイダー側のTXTレコードのNameフィールドにコピーします。Value を、DNSプロバイダー側のContentフィールドにコピーします。Verify and Finish をクリックして、手順を完了します。DNSレコードの更新と確認が完了するまで、数分かかる場合があります。設定ページを離れても、最初からやり直すことなく、後で戻って手順を完了できます。検証値は、最初に生成されてから48時間有効です。
デフォルトのロールとセッションタイムアウトを更新
SAML の設定が完了したら、すべてのユーザーにログイン時に割り当てるデフォルトのロールを設定し、セッションタイムアウトも調整できます。割り当て可能なシステムロールの一覧については、Console のロールと権限を参照してください。
管理者ユーザーを設定する
別の認証方式で設定されたユーザーは、組織内の管理者が削除するまで保持されます。
- 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 から再度ログインします。
アイデンティティプロバイダーを設定する
- 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 に戻り、手順を続けます。
トラブルシューティング
SAML でサインインした後に管理者権限がない
SAML でサインインした後に管理者権限がない
原因: 新しい SAML アカウントには、設定済みのデフォルトの SAML ロールが付与されます。そのロールが Admin でない場合、元のアカウントが Admin ロールを持っていても、新しいアカウントには管理者権限がありません。ClickHouse Cloud は SAML アカウントと非 SAML アカウントを自動的に関連付けません。対処: まず一度 SAML でサインインし、新しいユーザーが ClickHouse Cloud に表示されるようにします。その後ログアウトし、元の管理者アカウントでサインインして、SAML ユーザーに Admin ロールを割り当てます。
- メールアドレスとパスワードのアカウントの場合は、メールアドレスでのサインイン用リンク を使用して、SAML への自動リダイレクトを回避します。
?with=emailのemailはリテラル値であり、メールアドレスのプレースホルダーではありません。 - Google または Microsoft アカウントの場合は、Continue with Google または Continue with Microsoft を選択します。
システムの設定ミス、またはサービス障害の可能性があります
システムの設定ミス、またはサービス障害の可能性があります
原因: サポートされていない 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 は、組織ごとに個別の 接続 を設定することで、複数組織での SSO をサポートしています。各組織への初回ログインでは、その直接リンク (
https://console.clickhouse.cloud/?connection={organizationId}) を使用する必要があります。この初回ログインにより、その組織内にアカウントがプロビジョニングされます。組織で SCIM が有効になっている場合、アカウントはすでにプロビジョニングされているため、この手順は省略できます。以降のサインインでは、任意の SAML 組織にログインしてください。他の SAML 組織はコンソールのサイドバーにある組織切り替えメニューで利用でき、いずれかを選択すると、その組織の SSO を通じてサインインします。ユーザーが https://console.clickhouse.cloud でメールアドレスを入力した際に、該当ドメインのユーザーを自動的に組織へ振り分けないようにしたい場合は、その動作を無効にするようサポートチケットを起票してください。同じユーザーに対して複数のアカウントが表示されるのはなぜですか?
同じユーザーに対して複数のアカウントが表示されるのはなぜですか?
ClickHouse Cloud では、SSO アカウントと非 SSO アカウントは自動的に関連付けられないため、両方の方法でサインインしたユーザーは、同じメールアドレスであってもユーザー一覧に複数回表示されることがあります。
次のステップ
- クラウドユーザーの管理 — ユーザー権限を管理し、アクセスを SAML 接続のみに制限します。
- SCIM Provisioning — Okta または Microsoft Entra ID を使用して、ユーザーとグループのプロビジョニングを自動化します。
- Console roles and permissions — デフォルトの SAML ロールとして割り当て可能なロールを確認できます。