LinkedIn 認証プロバイダーの設定

登録ハンドラーの設定

シングルサインオンに認証プロバイダーを使用するには、登録ハンドラーを作成する必要があります。登録ハンドラーがユーザーを作成し、ID プロバイダーを介して Salesforce にアクセスする既存のユーザーを更新します。Apex または Flow Builder を使用して登録ハンドラを設定できます。詳細は、「Create an Authentication Provider Registration Handler (認証プロバイダー登録ハンドラーの作成)」を参照してください。

LinkedIn認証プロバイダーのApex登録ハンドラの例を次に示します。この登録ハンドラは、要求された範囲に r_liteprofile と r_emailaddress が含まれていることを前提としています。また、ユーザーがカスタマーポータルにログインしていることを想定しています。

メモ デフォルトの登録ハンドラーには、メールが必要です。現在認証済みのメンバーのメールアドレスを取得するには、次の要求を使用します。GET https://api.linkedin.com/v2/emailAddress?q=members&projection=(elements*(handle~))を参照してください。

例

//TODO:This auto-generated class includes the basics for a Registration
//Handler class. You will need to customize it to ensure it meets your needs and
//the data provided by the third party.
global class LinkedInRegHandler implements Auth.RegistrationHandler {
    //Creates a Standard salesforce or a community user
    global User createUser(Id portalId, Auth.UserData data) {
        if (data.attributeMap.containsKey('sfdc_networkid')) {
            //We have a community id, so create a user with community access
            //TODO: Get an actual account
            Account a =[SELECT Id FROM account WHERE name = 'LinkedIn Account'];
            Contact c = new Contact();
            c.accountId = a.Id;
            c.email = data.email;
            c.firstName = data.firstName;
            c.lastName = data.lastName;
            insert(c);
            //TODO: Customize the username and profile. Also check that the username 
            //doesn't already exist and possibly ensure there are enough org licenses
            //to create a user. Must be 80 characters or less.
            User u = new User();
            Profile p =[SELECT Id FROM profile WHERE name = 'Customer Portal Manager'];
            u.username = data.firstName + '@sfdc.linkedin.com';
            u.email = data.email;
            u.lastName = data.lastName;
            u.firstName = data.firstName;
            String alias = data.firstName;
            //Alias must be 8 characters or less
            if (alias.length() > 8) {
                alias = alias.substring(0, 8);
            }
            u.alias = alias;
            u.languagelocalekey = UserInfo.getLocale();
            u.localesidkey = UserInfo.getLocale();
            u.emailEncodingKey = 'UTF-8';
            u.timeZoneSidKey = 'America/Los_Angeles';
            u.profileId = p.Id;
            u.contactId = c.Id;
            return u;
        } else {
            //This is not a community, so create a regular standard user
            User u = new User();
            Profile p =[SELECT Id FROM profile WHERE name = 'Standard User'];
            //TODO: Customize the username. Also check that the username doesn't
            //already exist and possibly ensure there are enough org licenses
            //to create a user. Must be 80 characters or less
            u.username = data.firstName + '@salesforce.com';
            u.email = data.email;
            u.lastName = data.lastName;
            u.firstName = data.firstName;
            String alias = data.firstName;
            //Alias must be 8 characters or less
            if (alias.length() > 8) {
                alias = alias.substring(0, 8);
            }
            u.alias = alias;
            u.languagelocalekey = UserInfo.getLocale();
            u.localesidkey = UserInfo.getLocale();
            u.emailEncodingKey = 'UTF-8';
            u.timeZoneSidKey = 'America/Los_Angeles';
            u.profileId = p.Id;
            return u;
        }
    }
    //Updates the user's first and last name
    global void updateUser(Id userId, Id portalId, Auth.UserData data) {
        User u = new User(id = userId);
        u.lastName = data.lastName;
        u.firstName = data.firstName;
        update(u);
    }
}

LinkedIn の範囲を表示

LinkedIn アプリケーションの設定

1. LinkedIn の開発者アカウントにサインインします。
2. LinkedIn の上部にあるプロファイル写真をクリックして、[My Apps (私のアプリケーション)] を選択します。
3. [Create App (アプリケーションを作成)] をクリックします。
4. アプリケーション設定を入力します。
5. クライアント ID とクライアントの秘密をメモします。

Salesforce 組織での LinkedIn プロバイダーの定義

1. [設定] から、[クイック検索] ボックスに「認証プロバイダー」と入力し、[認証プロバイダー] をクリックしてから、[新規] をクリックします。
2. プロバイダータイプに [LinkedIn] を選択します。
3. プロバイダーの名前を入力します。
4. クライアント設定 URL に使用する URL サフィックスを入力します。たとえば、プロバイダーの URL サフィックスが MyLinkedInProvider である場合、SSO URL は https://mydomain_url または community_url /services/auth/sso/MyLinkedInProvider のようになります。
5. [コンシューマーの秘密] に LinkedIn クライアントの秘密を使用します。
6. Apex 登録ハンドラを使用するには、次の手順を実行します。
   1. [登録ハンドラ種別] で、[Apex] を選択します。
   2. [登録ハンドラ] で、Auth.RegistrationHandler インタフェースを実装する既存の Apex クラスを選択します。または、登録ハンドラのテンプレートを作成するには、[登録ハンドラテンプレートを自動的に作成] をクリックします。このクラスを後で編集してデフォルトのコンテンツを変更してから使用します。
7. 登録ハンドラーにフローを使用するには、次の手順を実行します。
   1. [登録ハンドラ種別] で、[フロー] を選択します。
   2. [登録ハンドラー] で、[ID ユーザー登録] フロー種別の既存のフローを選択します。
   3. デフォルトプロファイルを選択します。登録ハンドラーを実行するには、デフォルトプロファイルが必要です。ここでデフォルトプロファイルを指定しない場合、フロー自体でデフォルトプロファイルを設定します。

      認証プロバイダーユーザー登録フローテンプレートを使用する場合、ここで設定したプロファイルは defaultProfileId 変数に自動的に保存されます。

   4. デフォルトの取引先を選択します。Experience Cloud サイトで認証プロバイダーを使用している場合、このアカウントには新しい内部ユーザーが保存されます。

      「認証プロバイダーのユーザー登録」フローテンプレートを使用する場合、ここで設定したプロファイルは自動的に defaultAccountId 変数に保存されます。

8. [Execute Registration As (登録の実行ユーザー)] で、Apex クラスまたはフローを実行する実行ユーザーを選択します。このユーザーは「ユーザーの管理」権限を持っている必要があります。

   [他のアカウントで登録を実行] では、登録ハンドラーが動作するコンテキストが提供されます。本番環境では、通常、[他のアカウントで登録を実行] ユーザー用にシステムユーザーを作成します。このように、ハンドラーによって実行される操作は、その登録プロセスが簡単に特定されます。たとえば取引先責任者が作成される場合、システムユーザーがそれを作成します。

9. 必要に応じて、次の項目を設定します。
   • [承認エンドポイント URL] に「https://www.linkedin.com/oauth/v2/authorization」と入力します。
   • トークンエンドポイント URL には、LinkedIn から OAuth トークンの URL を指定します。たとえば「https://www.linked.com/oauth/v2/accessToken」と入力します。詳細は、「Authenticating with OAuth 2.0 Overview (OAuth 2.0 を使用した認証の概要)」を参照してください。
   • LinkedIn のプロファイル API から要求された値を変更する場合は、ユーザー情報エンドポイント URL を入力します。詳細は、「Profile API (プロファイル API)」を参照してください。URL は https://api.linkedin.com/v2/me で開始する必要があり、要求された項目は要求された範囲に対応している必要があります。
   • デフォルトの範囲には、サポートされている値または LinkedIn から取得する情報を表す値 (値が複数の場合は、スペースで区切られた値) を入力します。
   • コンシューマー鍵とコンシューマーの秘密を入力すると、コンシューマーの秘密がデフォルトで SOAP API の応答に含まれます。SOAP API 応答で秘密を表示しないようにするには、[SOAP API 応答にコンシューマーの秘密を含める] の選択を解除してください。2022 年 11 月より、メタデータ API 応答では、秘密が常にプレースホルダーの値に置き換えられます。デプロイ時に、プレースホルダーをプレーンテキストのコンシューマーの秘密に置き換えるか、後から UI で値を変更してください。
   • [カスタムエラー URL] に、プロバイダーがエラーの報告に使用する URL を入力します。
   • [アイコン URL] に、サイトのログインページのボタンとして表示するアイコンのパスを追加します。このアイコンは Experience Cloud サイトにのみ適用されます。Salesforce のログインページまたは [私のドメイン] のログイン URL には表示されません。ユーザーは、このボタンをクリックし、サイトに関連付けられた認証プロバイダーを使用してログインします。独自の画像へのパスを指定するか、いずれかのサンプルアイコンの URL を項目にコピーしてください。
   • LinkedIn ユーザーにポータルを使用するには、[ポータル] ドロップダウンリストからポータルを選択します。
10. ID プロバイダーの MFA サービスではなく、Salesforce 多要素認証 (MFA) 機能を使用するには、[この SSO プロバイダーで Salesforce MFA を使用] を選択します。この設定は、MFA が直接適用されているユーザーの MFA のみをトリガーします。詳細は、「SSO での Salesforce MFA の使用」を参照してください。
11. 変更内容を保存します。

LinkedIn アプリケーションの更新

SSO 接続のテスト

ログインページへの認証プロバイダーの追加