エンタープライズ SSO 設定ガイド
シングルサインオン(SSO)を利用すると、組織の既存のアイデンティティプロバイダー(IdP)を使って、チームメンバーがFlowHuntにアクセスできます。本ガイドでは、エンタープライズFlowHuntアカウントでSSO連携を設定する手順を解説します。

前提条件
SSO設定を始める前に、以下が揃っていることを確認してください。
- 有効なFlowHuntエンタープライズプラン
- 組織のMicrosoft Azure AD / Entra IDへの管理者権限
- FlowHuntワークスペースのオーナー権限
- ドメイン所有権を確認するためのDNSプロバイダーダッシュボードへのアクセス
設定手順
ステップ1:FlowHuntでSSO設定画面にアクセス
- 管理者としてFlowHuntアカウントにログインします
- 一般設定 > 認証 に進みます
- 対応するアイデンティティプロバイダーの SSOを設定 ボタンをクリックします

ステップ2:Microsoft Azure AD / Entra IDを選択
SSOはデフォルトで有効になっていることが表示されます。

ステップ3:FlowHunt SSO情報を取得
FlowHuntのSSO設定ページから Assertion Consumer Service(ACS)URL をコピーします。
ステップ4:アイデンティティプロバイダーを設定
- Azureポータルにログインします
- Azure Active Directory > エンタープライズアプリケーション > 新しいアプリケーション へ進みます

- 独自のアプリケーションを作成 を選択します

- 名前に「FlowHunt」と入力し、「ギャラリーに見つからない他のアプリケーションと統合」を選択します
- シングルサインオンのセットアップ を選択します
- 基本SAML構成を設定します:
- 識別子(エンティティID):
https://www.flowhunt.ioに設定 - 応答URL:FlowHuntの Assertion Consumer Service(ACS)URL を設定
- 識別子(エンティティID):
- ユーザー属性とクレーム のセクションで、以下の属性がマッピングされていることを確認します(デフォルトで正しく設定されています):
- Name ID:user.mail(メールアドレス)
- First Name:user.givenname
- Last Name:user.surname
- Email:user.mail
- 証明書(Base64) ファイルをダウンロードします
FlowHunt Test SSOのセットアップセクションから ログインURL をコピーします

ステップ7:FlowHuntでSSOを設定
- FlowHuntに戻ります
IdP SSO URLに、Microsoft Entra IDのLogin URLセクションからコピーしたURLを貼り付けます- Entra IDのページから
Microsoft Entra Identifierの値をIdP Entity IDに貼り付けます - ダウンロードした
Certificate (Base64)ファイルの内容をIdP Certificateに貼り付けます。これは-----BEGIN CERTIFICATE-----で始まり、-----END CERTIFICATE-----で終わる場合があります - ドメインの所有権を確認するために「ドメインを確認」ボタンをクリックし、指示に従ってTXTレコードをDNSプロバイダーに追加します

- ドメインの確認が完了したら、「SAML設定を更新」ボタンをクリックします。次のセクションでは、さらにSSO設定をカスタマイズ可能なSAML設定のオプションについて説明します。
ステップ8:高度なSAML設定(オプション)
ログイン方法
Any Method に設定すると、ユーザーはSSOまたはユーザー名/パスワードでサインインできます。Enforce SSO に設定すると、ユーザーはSSOのみでサインインする必要があります。
アカウントの自動作成(ジャストインタイムプロビジョニング)
有効にすると、初回サインイン時にFlowHuntで新しいアカウントが自動作成されます。無効の場合、ユーザーは手動でFlowHuntに追加する必要があります。
トラブルシューティング
SSO設定中に問題が発生した場合:
よくある問題と対策
「無効なSAMLレスポンス」エラー
- IdPサーバーの時刻が正しく同期しているか確認してください
- エンティティIDとACS URLが正しく設定されているか確認してください
SSOログイン後にユーザーがFlowHuntにアクセスできない
- IdPでユーザーがFlowHuntアプリケーションに割り当てられているか確認してください
- IdPのユーザーのメールアドレスとFlowHuntのメールアドレスが一致しているか確認してください
属性マッピングの問題
- 必要な属性(email、firstName、lastName)が正しくマッピングされているか確認してください
- 属性名の大文字・小文字の違いによる問題がないか確認してください
サポートの利用
SSO設定で問題が解決しない場合は:
- FlowHuntサポート(support@flowhunt.io)までご連絡ください
- サポートリクエストには以下の情報を含めてください:
- 組織名
- アイデンティティプロバイダー名
- 具体的なエラーメッセージ
- 設定画面のスクリーンショット(機密情報は塗りつぶしてください)
