메인 콘텐츠로 건너뛰기
테넌트에서 사용할 External Identity Provider를 설정하기 전에, External Identity Provider의 지정된 매개변수가 올바른지 확인합니다. Vantage API를 통해 외부 인증을 테스트하려면 사용하는 프로토콜에 따라 다음을 수행합니다:
  1. 사용하는 프로토콜에 따라 아래 표에 설명된 매개변수와 함께 다음 링크를 엽니다:
    • OAuth 2.0: https://<your-vantage-url>/api/v1/external/test-challenge?settings=<settings>&returnUrl=<returnUrl>
    • SAML 2.0: https://<your-vantage-url>/api/v1/external/test-challenge?settings=<settings>&returnUrl=<returnUrl>&tenantId=<tenantId>

​
매개변수

ParameterProtocolDescription
settingsOAuth 2.0JSON 형식의 외부 ID 공급자 인증 설정입니다. 외부 ID 공급자 유형(Kind 매개변수, AzureActiveDirectoryOidc 또는 OnPremiseActiveDirectoryOidc 값을 가질 수 있음), 외부 ID 공급자 URL(Authority 매개변수), 클라이언트 ID(ClientId 매개변수)를 포함합니다.

예를 들어:
{"Kind":"AzureActiveDirectoryOidc","Settings":{"Authority":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3","ClientId":"4e674698-09b8-4ac5-8df7-35d6f0c1e36c"}}
settingsSAML 2.0JSON 형식의 외부 ID 공급자 인증 설정입니다. 외부 ID 공급자 유형, 외부 ID 공급자 URL, 애플리케이션 ID URI(OwnEntityId로 사용됨)를 포함합니다.

예를 들어:
{"Kind":"Saml2","Settings":{"MetadataUri":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3/federationmetadata/2007-06/federationmetadata.xml","OwnEntityId":"api://a37892f6-c2e9-4092-b804-d054741da4da"}}
returnUrlOAuth 2.0 or SAML 2.0인증이 완료된 후 이동할 URL입니다. 테스트 목적이라면 /skills와 같은 Vantage 엔드포인트를 지정할 수 있습니다. URL 루트는 인가에 사용되는 링크에 자동으로 포함됩니다.
tenantIdSAML 2.0SAML 2.0 외부 ID 공급자를 통한 인증에 사용되는 테넌트 식별자입니다.
https://vantage-eu.abbyy.com/auth2/api/v1/account/external/test-challenge?settings={"Kind":"AzureActiveDirectoryOidc","Settings":{"Authority":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3","ClientId":"4e674698-09b8-4ac5-8df7-35d6f0c1e36c"}}&returnUrl=/skills

https://vantage-eu.abbyy.com/auth2/api/v1/account/external/test-challenge?settings={"Kind":"Saml2","Settings":{"MetadataUri":"https://login.microsoftonline.com/fb46032a-31c4-42ff-890d-6e08d6f57da3/federationmetadata/2007-06/federationmetadata.xml","OwnEntityId":"api://a37892f6-c2e9-4092-b804-d054741da4da"}}&returnUrl=/skills&tenantId=your_vantage_tenant_id
  1. 외부 Identity Provider의 자격 증명을 입력합니다.
  2. 인증 절차를 성공적으로 완료하면, 요청을 보낸 페이지 또는 returnUrl 매개 변수에 지정된 페이지로 리디렉션됩니다. 후자의 경우 해당 페이지의 주소 표시줄에는 인증된 사용자의 사용자 이름과 이메일 정보가 포함됩니다. 입력한 매개 변수가 올바르지 않으면 외부 Identity Provider 페이지에 인증 오류가 표시됩니다. 이 경우 설정이 올바른지 확인한 다음 필요한 변경을 수행하고 테스트를 다시 실행하십시오.