SeciossLinkでは、Salesforceとの間でシングルサインオン認証、及びユーザーのID同期が可能です。
サービス間の連携には、「Salesforce側での事前準備」、及び「SeciossLink側での連携準備」が必要となります。
後述する設定手順を参照することで、ID同期、及びシングルサインオン認証それぞれの設定方法を確認できます。
Salesforce側での事前準備
Salesforceの管理コンソールにログインしてください。
URL:https://<私のドメイン>.my.salesforce.com/lightning/setup/SetupOneHome/home
本マニュアル内の「私のドメイン」はSalesforceの管理コンソール > 設定 > 会社の設定 > 私のドメイン を参照してください。
参考:Salesforce 私のドメイン
シングルサインオン
Salesforce 側の設定 > ID > シングルサインオン設定で、以下のように設定して下さい。
- SAML のバージョン:2.0
- 発⾏者:https://slink.secioss.com/<テナントID>
- ユーザーID の種別:
テナントID とSalesforce のドメインが⼀致する場合“アサーションには、ユーザーの Salesforce ユーザ名が含まれます”を選択し、⼀致しない場合“アサーションには、ユーザーオブジェクトの統合ID が含まれます”を選択して下さい。
- SAML のユーザーID の場所:
ユーザーID はSubject ステートメントのNameIdentifier 要素にあります.。
- 証明書:
「SeciossLink管理コンソール」 - 「システム」-「IdP証明書」から”使用中”の証明書をダウンロードして、登録して下さい。
- ID プロバイダのログインURL:
https://slink.secioss.com/saml/saml2/idp/SSOService.php?tenant=<テナントID>
※Salesforceのシングルサインオンの設定を複数行っている場合、”&service=<サービスID>”を追加して下さい。
- ID プロバイダのログアウトURL:
https://slink.secioss.com/saml/saml2/idp/
initSLO.php?RelayState=/saml/logout.php&logout=salesforce
また、Salesforce 側で“私のドメイン”を設定していない場合、Salesforce にシングルサインオンするには、以下のURL にアクセスして下さい。
https://slink.secioss.com/saml/saml2/idp/SSOService.php?spentityid=<Salesforce のエンティティID>
Salesforce のカスタマポータルにログインする場合には、以下のURL にアクセスして下さい。
https://slink.secioss.com/saml/saml2/idp/SSOService.php?spentityid=<Salesforce のエンティティID>&organization_id=<Salesforce の組織ID>&portal_id=<カスタマポータルのポータルID>
※ SeciossLink のテナントID とSalesforce のドメインが異なり、ID 同期を⾏わない場合、Salesforce の管理画面からシングルサインオンを⾏うユーザーの“統合ID”にSeciossLink のユーザーID を登録して下さい。
OAuth 2.0選択時のID同期
1. Salesforce 側の設定 > 外部クライアントアプリケーション > 外部クライアントアプリケーションマネージャー で 「新規外部クライアントアプリケーション」を作成し、以下のように設定してください。
基本情報
- 外部クライアントアプリケーション名:任意の文字列を設定してください。(例:SAML-SeciossLink)
- API参照名:外部クライアントアプリケーション名に入力した文字列が表示されます。
- 取引先責任者 メール:メールアドレスを設定してください。
- 配信状態:ローカル
API(OAuth 設定の有効化)
- OAuth を有効化:チェックボックスにチェックを入れます。
アプリケーション設定
- コールバック URL:https://example.com/callback を設定してください。
- OAuth 範囲:API を使用してユーザーデータを管理 (api) を選択してください。
フローの有効化
- クライアントログイン情報フローを有効化:チェックボックスにチェックを入れます。
確認 ポップアップ「クライアントログイン情報フローの有効化を確認」が表示されますが、OKをクリックしてください。
2. 作成した外部クライアントアプリケーションを選択し、タブ「ポリシー」を操作します。
OAuth フローおよび外部クライアントアプリケーションの機能強化
- クライアントログイン情報フローを有効化:チェックボックスにチェックを入れます。
- (ユーザー名) として実行:実行ユーザーのユーザー名(メールアドレス形式)※Salesforceの管理者を指定してください。
3. 「設定」タブをクリックします。
3-1. アプリケーション設定内の「コンシューマー鍵と秘密」をクリックします。
3-2. Salesforceから管理者宛てに送信された確認コードのメールを確認し、確認コードを入力します。
SeciossLink側での事前準備
SeciossLink側での連携準備として、Salesforce側で取得した設定値を登録してください。
各手順によって、使用する管理画面が異なります。
設定時間、および動作確認にかかる時間はおよそ10分ほどです。
「シングルサインオン」-「クラウドサービス」から「Salesforce」を選択し、各種設定を実施してください。
SeciossLink側での設定
Salesforce シングルサインオン 設定画面
Salesforce シングルサインオン 設定項目
| 項目名 | 説明 |
| シングルサインオンの設定 | 有効化することで、Salesforceへのアクセス許可を設定しているユーザーに対してシングルサインオン認証が適用されるようになります。 |
| エンティティID | SAML のエンティティID ※Salesforce のシングルサインオン設定の“エンティティID”の値です。 |
| ログインURL | SAML のログインURL ※Salesforce のシングルサインオン設定の「エンドポイント」-「組織」-「ログインURL」の値です。 |
| ログアウトURL | Salesforce のログアウトURL ※Salesforce のログアウトボタンのリンクを設定してください。 例: https://xxx.salesforce.com/secur/logout.jsp |
| ID 同期 | 有効化することで、SalesforceとのID同期が実行されるようになります。 システム管理者のプロファイルで「API の有効化」が表示されていて、かつ、有効になっている場合(※1)に、本機能を有効にして下さい。 エディションが「Professional Edition」の場合、事前にAPIの有効化が行えるものか確認してください。 「Professional Edition」の上位のエディションの場合、APIの有効化が行えます。(デフォルト有効) |
| 認証方式 | ※「ID同期」を有効化することで選択可能となります。 SalesforceとのID同期で利用する認証方式を選択します。 ・SOAP API ※廃止予定 ・OAuth 2.0 |
| Salesforce 管理アカウント名 | ※「ID同期」を有効化し、認証方式「SOAP API」を選択している場合に入力可能となります。 Salesforceの管理アカウント名を入力します。 |
| 管理アカウントのパスワード | ※「ID同期」を有効化し、認証方式「SOAP API」を選択している場合に入力可能となります。 Salesforce側管理アカウントのパスワードを入力します。 |
| 管理アカウントのトークン | ※「ID同期」を有効化し、認証方式「SOAP API」を選択している場合に入力可能となります。 Salesforce側管理アカウントで発行したトークンを入力します。 |
| ドメイン | ※「ID同期」を有効化し、認証方式「OAuth 2.0」を選択している場合に入力可能となります。 Salesforce側管理アカウントで発行したトークンを入力します。 |
| クライアントID | ※「ID同期」を有効化し、認証方式「OAuth 2.0」を選択している場合に入力可能となります。 Salesforce側で発行した【コンシューマーの鍵】を入力します。 |
| クライアントシークレット | ※「ID同期」を有効化し、認証方式「OAuth 2.0」を選択している場合に入力可能となります。 Salesforce側で発行した【コンシューマーの秘密】を入力します。 |
| パスワード同期 | Salesforce とのパスワード同期の方法を選択します。 ・ なし(Salesforce側にパスワードを同期しない) ・ シングルサインオンのパスワード(SeciossLinkが持つユーザーのパスワード) ・ ランダムパスワード(SeciossLink側がランダムに生成したパスワード) |
| ユーザーの種類 | Salesforce のユーザーの種類を選択します。 ※“コミュニティユーザー”を選択すると通常のユーザーに加えてカスタマポータルのユーザーを登録可能になります。コミュニティユーザーを登録する場合、Salesforce のロールで“カスタマポータルの取引先”を必ず設定して下さい。 |
| 同期するユーザーの属性 | Salesforce 側の「ユーザー名」、「姓」、「名」、「別名」、「メール」、「従業員番号」をそれぞれSeciossLinkの属性から選択し、同期の際に使用します。 |
※1 確認方法は以下の通りです。
[1] Salesforceの「ホーム」タブをクリックして、「クイック検索」に”プロファイル”を入力して表示された”プロファイル”をクリックします。
[2] 表示された画面の右上部分に表示されている”A|B|・・・ワ|その他|全て”の中から”サ”をクリックし、”システム管理者”をクリックします。(表示されない場合には英語表記の”S”で表示されていないかについてもご確認ください)
[3] 「システム管理者権限」の「API の有効化」が表示されていて、かつ、有効化になっていることを確認します。