헤드리스 ID API: 비공개 클라이언트의 헤드리스 등록 플로

사용자의 타사 앱 열기 및 등록 클릭

사용자가 앱을 열고 등록 링크를 클릭하거나 링크를 클릭하여 등록이 필요한 자원에 액세스합니다.

앱의 등록 양식 표시

앱에 사용자 데이터를 수집하기 위한 등록 양식이 기본적으로 표시됩니다. 모양, 느낌, 수집할 사용자 정보 등 이 양식의 모든 사항을 제어합니다.

사용자에게 수집하려는 정보에 대해 몇 가지 사항을 고려해야 합니다. 앱이 헤드리스 등록 API에 사용자 정보를 제출하면 Salesforce에서 이메일 주소, 사용자 이름, 성(姓), 암호를 확인합니다. 사용자에게 이 정보를 수집하거나 자동으로 생성할 수 있으며, POST 요청에 포함시켜야 합니다. 포함할 정보를 결정할 때 사용자가 ID를 확인할 수 있도록 이메일 주소 또는 전화 번호를 수집해야 합니다.

사용자의 정보 입력

앱에서 사용자가 등록 양식에 정보를 입력합니다.

앱에서 헤드리스 등록 API에 사용자 정보를 헤드리스 상태로 전송

브라우저에서 앱이 AJAX(Asynchronous Java and XML)를 사용하여 Experience Cloud 사이트에서 헤드리스 등록 끝점(/services/auth/headless/init/registration)에 POST 요청을 보냅니다.

등록 요청에 다음 머리글을 포함하십시오.

요청 본문에 다음 매개 변수를 포함하십시오.

예제 POST 요청은 다음과 같습니다. 이 예에서 Experience Cloud 설정에서 인증 및 reCAPTCHA 모두 필수 항목으로 구성되어 있으므로 요청에 액세스 토큰 및 reCAPTCHA 토큰이 포함됩니다.

POST /services/auth/headless/init/registration? HTTP 1.1
Host: MyDomainName.my.site.com
Content-Type: application/json
Authorization: Bearer **************
{
 “userdata”: {
  “firstName”: “Janice”
   “lastName”: “Edwards”
   “email”: “janice.edwards@example.com”
   “username”: “jedwards@myapp.com”
    }
 “customdata”: {
   {”mobilePhone”=”<mobile phone number>”
   }
 “password”: “*******”
 “recaptcha”:”***********”
 “verificationmethod”: “email”
“emailtemplate”: “unfiled$public/SalesNewCustomerEmail”
}

Salesforce의 정보 수신 및 요청 식별자 반환

Salesforce가 사용자 정보를 수신합니다. Salesforce는 사용자의 ID를 확인하지 않으므로 나중에 처리하기 위해 이 정보를 대기열에 지정합니다.

POST 요청의 정보가 유효한 경우 Salesforce가 앱에 성공 메시지를 반환합니다. 이 메시지에는 플로의 이후 단계에서 중요한 등록 요청 식별자가 포함되어 있습니다. 성공 메시지 예제는 다음과 같습니다.

{
    "status": "success",
    "email": “jedwards@myapp.com”
    "identifier": “0RXXXXXXXX”
}

Salesforce에서 사용자에게 일회용 암호 전송

Salesforce에서 사용자 데이터를 수신하고 앱에 성공 메시지를 전송한 직후 사용자의 확인 방법에 따라 이메일 또는 SMS를 통해 일회용 암호(OTP)를 보냅니다.

앱의 확인 양식 기본 표시

성공 메시지가 표시되면 앱에 OTP 확인 양식이 기본적으로 표시됩니다. 다시 말해 확인 환경의 모양과 느낌은 전적으로 사용자에게 달려 있습니다.

사용자가 확인 양식에 OTP 입력

사용자가 이메일 또는 SMS를 통해 OTP를 수신하고 확인 양식에 입력합니다.

앱의 인가 코드 및 자격 증명 플로 시작

사용자가 ID를 증명하면 앱이 헤드리스 로그인 API에 대한 요청을 통해 즉시 인가 코드 및 자격 증명 플로에 착수합니다.

인가 요청에 다음 머리글을 포함하십시오.

요청 본문에 다음 매개 변수를 포함하십시오.

PKCE 등 헤드리스 로그인 API에 대한 요청 예제는 다음과 같습니다.

POST /services/oauth2/authorize? HTTP 1.1
Host: MyDomainName.my.site.com
Auth-Request-Type: user-registration
Auth-Verification-Type: email
Content-Type: application/x-www-form-urlencoded
Authorization: Basic <base64-encoded request ID:OTP>

response_type=code_credentials&
client_id=******&
redirect_uri=https://www.MyDomainName.my.site.com/services/apexrest/code/exchange&
code_challenge=Y29kZ*******

Salesforce의 요청 확인, 사용자 데이터 검색, 사용자 만들기

Salesforce가 인가 요청을 수신하고 요청 ID 및 OTP를 확인합니다. Salesforce는 이 정보를 사용하여 대기열에 있는 사용자 데이터를 검색하고 Experience Cloud 사이트에 구성된 헤드리스 등록 처리기를 호출합니다. Apex 처리기는 Salesforce에서 사용자를 만들고 계정에 연결합니다.

Salesforce가 코드 포함 사전 구성된 URL에 302 리디렉션 반환

Salesforce가 HTTP 302 리디렉션을 인가 코드가 포함된 사전 구성된 URL로 반환합니다. 302 리디렉션은 브라우저 내에서 처리되며, 응답은 서버의 사전 구성된 콜백 끝점인 리디렉션 URL에 헤드리스 상태로 전달됩니다. 예제 URL은 다음과 같습니다.

https://www.MyDomainName.my.site.com/services/apexrest/code/exchange?code=aPrxC1*******
&sfdc_community_url=https%3A%2F%2FMyDomainName.my.site.com&sfdc_community_id=0DBxxxxxxxxxxxx

콜백 처리기의 코드 추출 및 코드 교환 수행

서버측 콜백 처리기는 302 리디렉션에서 인가 코드 및 기타 매개 변수를 추출합니다. 그런 다음, 토큰 끝점에 헤드리스 POST 요청을 보내 코드 교환을 시작합니다.

액세스 토큰 요청의 경우 POST 요청만 사용할 수 있으며, Get 요청은 지원되지 않습니다. 이 요청에 필수인 머리글은 없지만 Content-Type 머리글을 포함할 수 있습니다.

요청 본문에 다음 매개 변수를 포함하십시오.

토큰 요청 예제는 다음과 같습니다.

POST /services/oauth2/token HTTP 1.1
Host: MyDomainName.my.site.com
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&
code=aPrxC1*******&
client_id=******&
client_secret=******&
redirect_uri=https://www.MyExperienceCloudSite.my.site.com/services/apexrest/code/exchange&
code_verifier=Y29kZ*******

Salesforce에서 액세스 토큰 부여

Salesforce는 토큰 요청을 확인하고 서버측 콜백 처리기에 액세스 토큰 응답을 반환합니다. 다음은 JSON 형식의 액세스 토큰 응답 예제입니다.

{
"access_token":"*******************",
"sfdc_community_url":"https://MyDomainName.my.site.com",
"sfdc_community_id":"0DBxxxxxxxxxxxx",
"signature":"ts6wm/svX3jXlCGR4uu+SbA04M6qhD1SAgVTEwZ59P4=",
"scope":"openid api",
"id_token":"XXXXXX",
"instance_url":"https://yourInstance.salesforce.com",
"id":"https://yourInstance.salesforce.com/id/00Dxxxxxxxxxxxx/005xxxxxxxxxxxx",
"token_type":"Bearer",
"issued_at":"1667600739962"
}

액세스 토큰 응답에는 다음의 매개 변수가 포함됩니다.

콜백 처리기의 토큰 응답 처리 및 앱에 매개 변수 반환

서버측 콜백 처리기는 응답에서 액세스 토큰을 가져온 다음, 사용자 데이터, 토큰, 세션 데이터와 함께 액세스 토큰 및 상태를 브라우저에 반환합니다. 가장 좋은 방법으로는 액세스 토큰을 반환하는 대신 서버를 구성하여 액세스 토큰을 저장하고 앱에 대한 세션을 만든 후 앱에 세션을 반환하는 것이 좋습니다. 개발자는 세션 만들기, 액세스 토큰 저장, 로그인 상태 관리를 포괄적으로 제어할 수 있으므로 세부적인 구현 방식은 사용자에게 달려 있습니다.

{"success":true,"state":"https://MyExperienceCloudSite.my.site.com/","errMsg":null,"access_token":"00*******"}

앱의 토큰 응답 처리 및 사용자 세션 만들기

앱이 토큰 응답을 수신하고 처리한 후 사용자 세션을 만듭니다.

앱에 사용자 등록 후 작업 수행

이제 사용자가 등록 및 로그인되며, 앱에서 Salesforce 데이터에 액세스해야 하는 작업을 수행합니다. 예를 들어 Salesforce에 저장되는 여행 예약 내역에 액세스하기 위해 버튼을 클릭합니다.

노트 인가 코드 및 자격 증명 플로에 연결된 앱 또는 외부 클라이언트 앱을 설정할 때 허용된 사용자 정책을 관리자 승인 사용자가 미리 인가됨으로 설정하고 앱에 액세스할 수 있는 프로필 또는 권한 집합을 구성합니다. 이 정책을 사용하면 사용자가 앱을 인가하지 않고 액세스하므로 앱이 사용자의 데이터에 액세스할 수 있게 허용하는 인가 화면 메시지가 나타나지 않습니다.

앱이 Salesforce 끝점에 인증된 호출 수행

사용자의 Salesforce 데이터에 액세스하기 위해 앱은 액세스 토큰을 사용하여 Salesforce API와 같은 보호된 Salesforce 끝점에 인증된 호출을 수행합니다.

사용자의 Salesforce 데이터 액세스 허용

이제 사용자가 앱에서 보호된 Salesforce 데이터에 액세스할 수 있습니다. 예를 들어 사용자는 자신의 여행 예약 내역을 볼 수 있습니다.