설명서Adobe PassAdobe Pass 인증

(기존) REST API 참조 rest-api-reference

마지막 업데이트: 2026년 10월 8일
NOTE
이 페이지의 컨텐츠는 정보용으로만 제공됩니다. 이 API를 사용하려면 Adobe의 현재 라이선스가 필요합니다. 허가되지 않은 사용은 허용되지 않습니다.
IMPORTANT
제품 알림 페이지에서 집계한 최신 Adobe Pass 인증 제품 알림 및 서비스 중단 타임라인에 대한 정보를 계속 받아 보십시오.

조절 메커니즘

Adobe Pass 인증 REST API는 조절 메커니즘에 의해 제어됩니다.

응답 형식 response-formats

NOTE
이러한 서비스에 제공된 API는 XML 또는 JSON(응답을 반환하는 API의 경우)으로 응답을 반환할 수 있습니다. 요청에 응답 형식을 지정하는 방법에는 세 가지가 있습니다.
  • HTTP Accept 헤더를 application/xml 또는 application/json(으)로 설정합니다.
  • 요청 페이로드에서 매개 변수 format=xml 또는 format=json을(를) 지정하십시오.
  • 확장 .xml 또는 .json을(를) 사용하여 웹 서비스 끝점을 호출합니다. 예: /regcode.xml 또는 /regcode.json
위의 방법 중 하나를 지정할 수 있습니다. 형식이 충돌하는 여러 메서드를 지정하면 오류가 발생하거나 원하지 않는 출력이 발생할 수 있습니다.

REST API 끝점 clientless-endpoints

<레지스트리_FQDN>:

<SP_FQDN>:

웹 서비스 요약 web_srvs_summary

아래 표에는 클라이언트 없는 접근 방식에 사용할 수 있는 웹 서비스가 나열되어 있습니다. 자세한 내용을 보려면 웹 서비스 끝점을 클릭합니다(샘플 요청 및 응답, 입력 매개 변수, HTTP 메서드 등).

​| Sr | 웹 서비스 끝점 | 설명 | . | 호스팅 위치 | 호출자 |
|-----|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------------|-----------------------------|
| 1. | <REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode | 임의로 생성된 등록 코드 및 로그인 페이지 URI를 반환합니다. | 2 | Adobe
코드 서비스 | 스마트 장치 |
| 2. | <REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode/
{registrationCode} | 등록 코드 UUID, 등록 코드 및 해시된 장치 ID가 포함된 등록 코드 레코드를 반환합니다. | 8 | Adobe
코드 서비스 | Adobe Pass 인증 |
| 3. | <SP_FQDN>/api/v1/config/
{requestorId} | 요청자에 대해 구성된 MVPD 목록을 반환합니다. | 5 | Adobe
Adobe Pass
인증
서비스 | 로그인
웹
앱 |
| 4. | <SP_FQDN>/api/v1/인증 | MVPD 선택 이벤트를 알려 AuthN 프로세스를 시작합니다. MVPD에서 성공적인 응답을 받으면 조정되는 인증 데이터베이스에 레코드를 만듭니다(13단계) | 7 | Adobe
Adobe Pass
인증
서비스 | 로그인
웹
앱 |
| 5. | SAML 어설션 소비자 | Adobe Pass 인증과 MVPD 간의 기존 SAML 워크플로 | 13 | Adobe Pass
인증
서비스 | Adobe Pass 인증 |
| 6. | <SP_FQDN>/api/v1/checkauthn/
{registrationCode} | 로그인 웹 앱은 시도한 로그인 흐름이 성공했는지 확인할 수 있습니다 | | Adobe Pass
인증
서비스 | 로그인
웹
앱 |
| 7. | <SP_FQDN>/api/v1/tokens/authn | AuthN 토큰 관련 메타데이터 가져오기 | 15 | Adobe Pass
인증
서비스 | 스마트 장치 |
| 8. | <REGGIE_FQDN>/reggie/v1/
{requestorId}/regcode/
{registrationCode} | 정규 코드 레코드를 삭제하고 재사용을 위해 정규 코드를 해제합니다. | 16 | Adobe
코드 서비스 | Adobe Pass 인증 |
| 9. | <SP_FQDN>/api/v1/authorize | 인증 응답을 가져옵니다. | 17 | Adobe Pass
인증
서비스 | 스마트 장치 |
| 10. | <SP_FQDN>/api/v1/checkauthn | 장치에 만료되지 않은 AuthN 토큰이 있는지 여부를 나타냅니다. | | Adobe Pass
인증
서비스 | 스마트 장치 |
| 11. | <SP_FQDN>/api/v1/tokens/authn | 발견되면 AuthN 토큰을 반환합니다. | | Adobe Pass
인증
서비스 | 스마트 장치 |
| 12. | <SP_FQDN>/api/v1/tokens/authz | 발견된 경우 AuthZ 토큰을 반환합니다. | | Adobe Pass
인증
서비스 | 스마트 장치 |
| 13. | <SP_FQDN>/api/v1/토큰/미디어 | 발견된 경우 짧은 미디어 토큰 반환 - /api/v1/mediatoken과 동일 | | Adobe Pass
인증
서비스 | 스마트 장치 |
| 14. | <SP_FQDN>/api/v1/mediatoken | 짧은 미디어 토큰 가져오기 | | Adobe Pass
인증
서비스 | 스마트 장치 |
| 15. | <SP_FQDN>/api/v1/사전 승인 | 사전 승인된 리소스 목록을 검색합니다. | | Adobe Pass
인증
서비스 | 스마트 장치 |
| 16. | <SP_FQDN>/api/v1/사전 승인/{code} | 사전 승인된 리소스 목록을 검색합니다. | | Adobe Pass
인증
서비스 | 로그인 웹 앱 |
| 17. | <SP_FQDN>/api/v1/로그아웃 | 저장소에서 AuthN 및 AuthZ 토큰 제거 | | Adobe Pass
인증
서비스 | 스마트 장치 |
| 18. | <SP_FQDN>/api/v1/토큰/사용자 메타데이터 | 인증 흐름이 완료된 후 사용자 메타데이터를 가져옵니다. | 해당 사항 없음 | 해당 사항 없음 | 스마트 장치 |
| 19. | <SP_FQDN>/api/v1/인증/자유 미리 보기 | 임시 패스 또는 프로모션 임시 패스에 대한 인증 토큰 만들기 | 해당 사항 없음 | Adobe Pass
인증
서비스 | 스마트 장치 |

REST API 보안 security

모든 Adobe Pass 인증 REST API는 보안 통신을 위해 HTTPS 프로토콜을 사용하여 호출해야 합니다. 또한 호출된 API의 대부분은 액세스 토큰 검색 API 설명서에 설명된 대로 가져온 액세스 토큰을 포함해야 합니다.

recommendation-more-help
pass-help-authentication