freeeサイン for Salesforce 初期設定-4.シングルサインオン(SSO)設定を行う（V3.90以降）

ご利用のパッケージバージョンとSAML認証方式について

freeeサイン for Salesforceでは、パッケージのバージョンによってシングルサインオン（SSO）をご利用いただくためのSAML認証の方式が異なります。

【バージョンと認証方式の対応表】

「freeeサインのSAML認証」にてSSOを設定中のお客様へ

従来の「freeeサインのSAML認証」によるSSOは、V3.90以降にアップデートした場合でも設定変更は不要でそのままご利用できます。

別途、ご案内中のログインアカウントの「freeeアカウント」への統一に伴い、2026年11月末以降、順次「freee共通のSAML認証」への移行をお願いしています。

実際の移行作業を行っていただくタイミングで、本ページ「freeeサインのSAML認証からfreee共通のSAML認証に移行されるお客様へ」の手順に従って設定を変更してください。

シングルサインオン（SSO）の概要

通常、freeeサインの文書詳細画面を開くにはパスワードの入力が必要です。

シングルサインオン（SSO）を設定すると、Salesforceにログイン中のユーザーは、パスワード入力なしでFS契約レコードからfreeeサインの文書詳細画面へ直接遷移できます。

シングルサインオン（SSO）でのアクセスについて

「FS契約レコード」のリンク項目に表示された［freeeサイン文書参照はこちら］をクリックすると、freeeサインにログインされ、作成された文書詳細ページに遷移します。

• SSO認証方式について
  freeeサインで利用できるSSOの認証方式は、SAML2.0です。

• freeeサインの文書詳細画面へアクセスする目的
  通常の操作はSalesforce上のFS契約レコードで行いますが、一部の機能や情報はfreeeサインの文書詳細画面でのみ利用・確認できます。必要に応じてfreeeサインへアクセスする際に、SSO設定が有効です。

freeeサインで確認・利用できる機能は、以下の表の通りです。

freeeサインのSAML認証からfreee共通のSAML認証に移行されるお客様へ

すでにfreeeサインのSAML認証（SSO）をご利用中のお客様が、新しい共通認証へ移行する際の手順と注意点です。以下の手順に沿って、移行作業を行ってください。

① 事前準備

移行作業を開始する前に、設定を担当するSalesforceユーザーがページ冒頭の「注意」に記載された必須条件を満たしているかご確認ください。

満たしていない場合は、条件を満たすための対応を事前に行ってください。 

② 移行時における作業手順の変更点

設定手順のうち、以下の作業が異なります。

• 権限セットの新規作成・新規割り当ては「不要」
  既存のSAML設定で使用している権限セットをそのまま利用するため、「① SSO用の権限セットを作成する」および「② 作成したSSO用の権限セットを割り当てる」の作業はスキップしてください。

• カスタム設定の登録時、旧URLは「削除」
  「⑥ カスタム設定にSSOの設定を登録する」の操作時、新しく取得したURLを「SSO URL（freeeアカウント管理発行）」に登録してください。あわせて、既存の「SSO URL（freeeサイン発行）」に入力されている値がある場合は、設定を正しく管理するために必ず削除してください。

設定手順

① SSO用の権限セットを作成する

SSOを利用できるユーザーは、権限セットで制御します。

本手順では、SSO用の権限セットを作成します。

1. ［クイック検索］欄に「権限セット」と入力して検索します。
2. ［権限セット］から、［新規］をクリックします。
   

3. 「権限セット」の作成画面に遷移したら、必要事項を入力し、［保存］をクリックします。
   

   番号	項目名	入力内容
   ①	表示ラベル	freeeサイン_User_SAMLを入力します。
   ②	API参照名	FS_User_SAMLを入力します。

4. 「権限セット」の設定画面に遷移したら、画面最下部までスクロールし、「システム」欄の［システム権限］をクリックします。
   
5. ［編集］をクリックします。
   

6. 「システム権限」の一覧から、以下の項目の「有効」にチェックを入れます。
   

   権限の名前	説明
   すべての外部クライアントアプリケーションの表示	すべての外部クライアントアプリケーションを表示します。

7. 画面を最上部までスクロールし、［保存］をクリックします。
   
8. 「権限変更確認」ウィンドウが表示されたら、［保存］をクリックします。
   

以上で権限セットの作成は完了です。

つづいて「② 作成したSSO用の権限セットを割り当てる」に進みます。

② 作成したSSO用の権限セットを割り当てる

本ページ「① SSO用の権限セットを作成する」で作成した権限セット「freeeサイン_User_SAML」を、freeeサインの文書詳細ページへのアクセスを許可したいSalesforceユーザーに割り当てます。

権限セットの割り当ては、SSO設定の必要な手順の1つです。

• 権限セットの割り当て手順については、「freeeサイン for Salesforce 初期設定-3.権限設定を行う - ③権限セットを割り当てる」のヘルプページをご覧ください。
• 権限セットの割り当てが完了したら、つづいて「③ IDプロバイダーを有効化しメタデータを準備する」に進みます。

③ ID プロバイダーを有効化しメタデータを準備する

SalesforceからfreeeサインへSSOで接続するには、Salesforceを認証元（ID プロバイダー）として機能させる必要があります。

本手順では、ID プロバイダーを有効化し、freeeサインとの連携に必要なメタデータをダウンロードします。

1. Salesforceの「設定」画面で、画面左部の［クイック検索］欄に「IDプロバイダー」と入力して検索します。

2. 検索結果から［ID プロバイダー］を選択し、［ID プロバイダーを有効化］をクリックします。
   

3. 「ID プロバイダーの設定」画面へ遷移したら、freeeサインとの通信に使用する証明書の選択を要求されます。任意の証明書を選択し、［保存］をクリックします。
   ※本画面が表示されず、次の手順④の画面が表示される場合は、本手順をスキップして手順④へ進みます。
   
4. 有効化が完了し「ID プロバイダーの設定」画面へ遷移したら、［メタデータのダウンロード］をクリックします。
   

ファイルがダウンロードできたことを確認できたら、つづいて、freeeアカウント管理にシングルサインオンの設定を行うために、本ページ「④ freeeアカウント管理にSSOメタデータをアップロードする」へ進みます。

④ freeeアカウント管理にSSOメタデータをアップロードする

SalesforceとfreeeサインをSSO連携するには、freeeアカウント管理側でSalesforceを認証元として認識させる必要があります。

本手順では、本ページ「③ IDプロバイダーを有効化しメタデータを準備する」で保存したメタデータファイルを使用して、freeeアカウント管理にSSO設定を登録します。

freeeアカウント管理の［事業所管理］メニュー →［セキュリティ］を開き、［SAML SSO］のセクションからSAMLの設定を行います。

1. ［SAML SSO設定］を開きます。

2. ［IDプロバイダ（IdP）の設定］→ ［メタデータをアップロード］からステップ「③ ID プロバイダーを有効化しメタデータを準備する」でダウンロードしたメタデータをアップロードします。
   
3. ［保存する］ボタンをクリックします。

つづいてSalesforceにfreeeアカウント管理の認証情報を登録するために、本ページ「⑤ Salesforceにfreeeアカウント管理のSAML情報を登録する」へ進みます。

freeeアカウント管理の情報を利用するのでページは開いたままにしてください。

⑤ Salesforceにfreeeアカウント管理のSAML情報を登録する

本手順では、まずSalesforceからfreeeサイン（外部サービス）へSSO接続するために必要なfreeeアカウント管理のSAML情報の登録を行うために、「外部クライアントアプリケーション」を作成します。

1. ［クイック検索］欄に「アプリケーションマネージャー」と入力し、検索します。
2. ［外部クライアントアプリケーションマネージャー］から、［新規外部クライアントアプリケーション］をクリックします。
   

3. 「外部クライアントアプリケーションマネージャー」の登録画面へ遷移したら、必要事項を入力します。
   
   【基本情報】

   番号	項目名	入力内容
   ①	接続外部クライアントアプリケーション名	freeeAccount_SAMLを入力します。
   ②	取引先責任者メールアドレス	設定作業者のSalesforceアカウントのメールアドレスを入力します。
   ③	API参照名	freeeAccount_SSOを入力します。
   ④	配信状態	［ローカル］を選択します。

4. ［Webアプリケーション（SAML設定の有効化）］をクリックして展開します。
   ※「⑥エンティティID」以降の項目は、「⑤SAMLの有効化」にチェックを入れることで展開します。

5. freeeアカウント管理の［SAML SSO設定］画面の「freee（サービスプロバイダ）」情報を入力したら、［作成］をクリックします。
   
   【Webアプリケーション（SAML設定の有効化）】

   番号	項目名	入力内容
   ⑤	SAMLの有効化	チェックを入れます。
   ⑥	エンティティID	freeeアカウント管理の［SAML SSO設定］画面の「freee（サービスプロバイダ）」の「EntityID」を入力します。
   ⑦	ACS URL	freeeアカウント管理の［SAML SSO設定］画面の「freee（サービスプロバイダ）」の「ACS URL」を入力します。
   ⑧	件名種別	「ユーザー名」を選択します。
   ⑨	SAMLメッセージの署名アルゴリズム	「SHA256」を選択します。

   ※freeeアカウント管理の「SAML SSO設定」画面で「⑥エンティティID」・「⑦ACD URL」に入力する情報が確認できます。
   

6. 作成したアプリケーションに関する「外部クライアントアプリケーションを管理」画面へ遷移したら、つづいて権限セットを登録します。［編集］をクリックします。
   
7. 「選択可能な権限セット」から、本ページ「① SSO用の権限セットを作成する」で作成した「freeeサイン_User_SAML」を選択し、［追加］ボタン（右向き三角）をクリックします。「選択済みの権限セット」に移動したら、［保存］をクリックします。
   
   

これでSalesforceと本ページ①で作成した権限セットに、freeeアカウント管理の情報を登録することができました。

つづいて、「⑥ カスタム設定にSSOの設定を登録する」に移動します。

⑥ カスタム設定にSSOの設定を登録する

本手順では、FS契約レコードの「リンク」項目にSSO用のURLを正しく作成するため、カスタム設定に外部クライアントアプリケーション登録で発行されたSAML認証用ログインURLを登録し、SSOの設定を行います。

1. 本ページの「⑤ Salesforceにfreeeアカウント管理のSAML情報を登録する」で作成した外部クライアントアプリケーション内の［SAMLポリシー］をクリックして展開し、「SAMLログイン情報」が表示されるまでスクロールします。
   

2. 「SAMLログイン情報］をクリックして展開したら、［Idp-initのログインURL］をコピーし、メモ帳などに張り付けておきます。
   

   URLの選択範囲が不足するとSSO用のURLを正しく作成できず、SSOの認証に失敗します。選択範囲が不足しないよう、URLを右クリックして「リンクのアドレスをコピー」などでURLを取得することを推奨します。

3. ［クイック検索］欄に「カスタム設定」と入力し、検索します。
   ［カスタム設定］から、「freeeサイン」の［Manage］をクリックします。
   
4. freeeサインの「カスタム設定」画面へ遷移したら、［編集］をクリックします。
   

5. 「freeeサインの編集」画面へ遷移したら、必要事項を入力します。
   

   番号	項目名	入力内容
   ①	チームID	freeeサインのチームIDを入力します。 チームIDの確認方法は、「プラン・チームIDを確認する」のヘルプページをご覧ください。
   ②	SSO URL （freeeアカウント管理発行）	本手順②で取得した「Idp-initのログイン」のURLを入力します。 ※「SSO URL(freeeサイン発行)」と間違えないようご注意ください。

6. 必要事項を入力したら、［保存］をクリックします。
   
7. 「カスタム設定」画面に遷移し、入力した内容が表示されていることを確認したら、カスタム設定の登録は完了です。
   

つづいて、「⑦ freeeアカウント管理でSSOの認証テストを行い、有効化する」でSSOの設定全体に問題がないかを確認します。

⑦ freeeアカウント管理でSSOの認証テストを行い、有効化する

本手順では、SSOの設定が正しく動作するか認証テストを行います。

freeeアカウント管理の［事業所管理］メニュー →［セキュリティ］を開き、［SAML SSO］のセクションからSAMLの設定を行います。

1. freeeアカウント管理の［SAML SSO設定］を開きます。
2. ［接続テスト（外部サイトに移動）］のボタンをクリックして、接続テストを実行します。
   
3. 接続テストに成功した場合は次の手順に進みます。
   接続テストに成功すると、「接続テストに成功しました。」のメッセージが表示されます。
   
4. ［有効にする］ボタンをクリックしてください。
   SAML接続の有効化に成功すると「SAML SSOを始める準備ができました」のメッセージが表示されます。
   

5. freeeアカウント管理で、SAMLログインを有効にする従業員を選択します。以下のヘルプページをご参照ください。

   • SAMLログインを設定する - freeeで人単位でSAML ログインを有効にする

以上で設定作業は完了です。

認証テストが成功しない場合

表示されたメッセージに応じて、以下の表から該当する内容を確認し、必要に応じて設定を修正します。