HubSpot SSO設定ガイド：導入効果と手順完全解説

1. SSO 導入の効果と全体像

2. HubSpot 管理画面で SSO を有効化する手順

1. HubSpot に管理者権限でログイン → 右上の 設定アイコン (⚙️) をクリック。
2. 左サイドバー 「セキュリティ」 > 「ログイン」 タブを開く。
3. 「シングルサインオン（SSO）を要求する」 にチェックを入れる。
4. 画面下部の 「保存」 ボタンで確定。

参考：公式 KB のページは執筆時点で以下 URL が有効です。
- HubSpot Knowledge Base – シングルサインオンの設定（SSO） （2026‑04‑15 参照）

効果：チェックを入れるだけで、HubSpot は外部 IdP の認証要求のみ受け付けるモードに切り替わります。ユーザーは HubSpot ログイン画面から「SSO でサインイン」ボタンをクリックし、IdP の認証画面へリダイレクトされます。

3. IdP（Identity Provider）側の設定とメタデータ取得

共通項目（執筆時点）

注記：上記 URL・Entity ID は HubSpot が自動提示するものです。変更があった場合は HubSpot の「SSO 設定」画面に再度表示されます。

3‑1. Okta の設定手順

3‑2. Google Workspace の設定手順

1. 管理コンソールの 「セキュリティ」→「シングルサインオン（SSO）」 に移動。
2. 「カスタム SAML アプリ」を追加し、アプリ名を「HubSpot」。
3. ACS URL と Entity ID を入力し、証明書（PEM）をアップロード。
4. 「ダウンロード」 ボタンからメタデータ XML を取得。

3‑3. SmartHR の設定手順

1. 管理画面の 「連携設定」→「SAML 認証」 に進む。
2. 「新規アプリケーション」作成で名称に「HubSpot SSO」を入力し、ACS URL・Entity ID を設定。
3. 保存後 「メタデータダウンロード」 リンクから XML ファイルを取得。

参考：SmartHR ヘルプページは執筆時点で以下が有効です。
- SmartHR ヘルプ – HubSpot の SAML 認証設定方法 （2026‑04‑15 参照）

4. HubSpot へメタデータをアップロードし本格稼働させる

1. 前節で有効化した 「シングルサインオン（SSO）を要求する」 設定画面に留まります。
2. ページ下部の 「SAML メタデータ」 セクションで 「ファイルを選択」 → ダウンロード済み XML を指定。
3. アップロード後、プレビュー画面で Entity ID と SSO URL が正しいか確認。
4. 必要に応じて除外対象ユーザー（次節参照）を設定し、「保存」。

5. SCIM 連携概要と実装手順へのリンク

6. テスト・検証とトラブルシューティング

6‑1. テストユーザーでのサインイン確認

合格基準
- ユーザー名・メールアドレスが正しく HubSpot に反映。
- エラーメッセージが出ず、ダッシュボードへ遷移できる。

6‑2. 主なエラーと対処法

トラブルシューティング手順

1. エラーメッセージをコピー → HubSpot ヘルプで検索（「ヘルプ」→「サポートに問い合わせ」）。
2. IdP の SAML 設定画面に戻り、対象項目（ACS URL・証明書・属性）を再確認。
3. メタデータを再アップロードし、設定保存後にテストユーザーで再度サインイン。

6‑3. 非公開コンテンツへのアクセス検証

1. HubSpot の 「マーケティング」→「ウェブサイト」→「ページ」 で非公開ページを作成。
2. ページの閲覧制限で 「特定のコンタクトリストにのみ表示」 を選択し、テストユーザーが所属するリストへ追加。
3. テストユーザーで SSO ログイン後、URL に直接アクセスしてページが表示されるか確認。

参考：
🔗 HubSpot – 非公開コンテンツへの SSO アクセス設定（2026‑04‑15 参照）

7. 除外対象ユーザーの実務例

除外ユーザーは 「設定」→「セキュリティ」→「ログイン」→「除外対象ユーザー」 にメールアドレスをカンマ区切りで入力してください。

8. 運用ポイントと次のアクション

次のアクション

1. 本ガイドに沿って SSO 設定 → メタデータアップロード → テスト を完了させる。
2. SCIM 連携が必要な場合は、上記「SCIM 連携概要」リンク先を参照し、IdP 側でエンドポイントとトークンを取得後に HubSpot に設定する。
3. 設定完了後は 証明書更新スケジュール と 除外対象ユーザーリスト を社内カレンダー・Wiki に登録し、運用体制を確立する。

9. 参照情報・リンクの有効性確認

注意：上記 URL が将来的に変更された場合は、HubSpot のトップページから「Knowledge Base」へ検索し最新情報をご確認ください。

本ガイドは実務での導入・運用を前提に作成しました。設定ミスや環境差異がある場合は、必ず公式ドキュメントと併せてご確認ください。