설명서Adobe PassAdobe Pass 인증

등록 페이지 registration-page

Last update: Wed Mar 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

REST API 끝점 clientless-endpoints

NOTE
이 페이지의 컨텐츠는 정보용으로만 제공됩니다. 이 API를 사용하려면 Adobe의 현재 라이선스가 필요합니다. 허가되지 않은 사용은 허용되지 않습니다.
NOTE
REST API 구현은 조절 메커니즘

<reggie_fqdn>:

<sp_fqdn>:

설명 create-reg-code-svc

임의로 생성된 등록 코드 및 로그인 페이지 URI를 반환합니다.

엔드포인트
호출됨
작성자:
입력
매개 변수
HTTP
방법
응답
HTTP
응답
<reggie_fqdn>/reggie/v1/{requestor}/regcode
예:
REGGIE_FQDN/reggie/v1/sampleRequestorId/regcode
스트리밍 앱
또는
프로그래머 서비스
1. 요청자
(경로 구성 요소)
2. deviceId(해시됨)
(필수)
3. device_info/X-Device-Info (필수)
4. mvpd(선택 사항)
5. ttl (선택 사항)
6. deviceType
7. deviceUser (사용하지 않음)
8. appId (사용하지 않음)
POST
실패한 경우 등록 코드 및 정보 또는 오류 세부 정보가 포함된 XML 또는 JSON. 아래 스키마 및 샘플을 참조하십시오.
201
입력 매개 변수
설명
요청자
이 작업이 유효한 Programmer requestorId입니다.
deviceId
장치 ID 바이트입니다.
device_info/
X-Device-Info
스트리밍 장치 정보입니다.
참고: URL 매개 변수로 device_info를 전달할 수 있지만, 이 매개 변수의 잠재적 크기와 GET URL 길이 제한으로 인해 http 헤더에서 X-Device-Info로 전달해야 합니다.
의 전체 세부 정보 보기 전달 장치 및 연결 정보.
mvpd
이 작업이 유효한 MVPD ID.
ttl
이 regcode가 유지되어야 하는 시간(초)입니다.
참고: ttl에 허용되는 최대값은 36000초(10시간)입니다. 값이 높을수록 400 HTTP 응답(잘못된 요청)이 발생합니다. If ttl 을 비워 두면 Adobe Pass 인증은 기본값으로 30분을 설정합니다.
deviceType
디바이스 유형(예: Roku, PC).
이 매개 변수가 올바르게 설정되면 ESM은 다음과 같은 지표를 제공합니다. 장치 유형별 분류 예를 들어 Roku, AppleTV 및 Xbox와 같은 다양한 유형의 분석을 수행할 수 있도록 Clientless를 사용할 때
다음을 참조하십시오. 전달 지표에서 클라이언트 없는 장치 유형 매개 변수 사용의 이점​
참고: device_info가 이 매개 변수를 대체합니다.
deviceUser
장치 사용자 식별자.
appId
애플리케이션 ID/이름입니다.
참고: device_info가 이 매개 변수를 대체합니다.
CAUTION
스트리밍 장치 IP 주소


클라이언트-서버 구현의 경우 스트리밍 장치 IP 주소는 이 호출과 함께 암시적으로 전송됩니다. 서버 간 구현의 경우 regcode 스트리밍 장치가 아닌 프로그래머 서비스를 호출하려면 스트리밍 장치 IP 주소를 전달하려면 다음 헤더가 필요합니다.
code language-none 
X-Forwarded-For : <streaming_device_ip>
위치 <streaming\_device\_ip> 는 스트리밍 장치 공용 IP 주소입니다.



예 :
code language-none 
POST /reggie/v1/{req_id}/regcode HTTP/1.1</br>X-Forwarded-For:203.45.101.20

응답 XML 스키마 xml-schema

등록 코드 XSD registration-code-xsd

    <?xml version="1.0" encoding="UTF-8"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="model.mvc.reggie.pass.adobe.com"
            targetNamespace="model.mvc.reggie.pass.adobe.com"
            attributeFormDefault="unqualified"
            elementFormDefault="unqualified">
        <xs:element name="regcode">
            <xs:complexType>
                <xs:all>
                    <xs:element name="id" type="xs:string" />
                    <xs:element name="code" type="xs:string" />
                    <xs:element name="requestor" type="xs:string" minOccurs="1" maxOccurs="1"/>
                    <xs:element name="mvpd" type="xs:string" minOccurs="1" maxOccurs="1"/
                    <xs:element name="generated" type="xs:long" />
                    <xs:element name="expires" type="xs:long" />
                    <xs:element name="info" type="infoType" maxOccurs="1"/>
                </xs:all>
            </xs:complexType>
        </xs:element>
        <xs:complexType name="infoType">
            <xs:all>
                <xs:element name="deviceId" type="xs:base64Binary" minOccurs="1" maxOccurs="1"/>
                <xs:element name="deviceType" type="xs:string" minOccurs="0" maxOccurs="1"/>
                <xs:element name="deviceUser" type="xs:string" minOccurs="0" maxOccurs="1"/>
                <xs:element name="appId" type="xs:string" minOccurs="0" maxOccurs="1"/>
                <xs:element name="appVersion" type="xs:string" minOccurs="0" maxOccurs="1"/>
                <xs:element name="registrationURL" type="xs:anyURI" minOccurs="0" maxOccurs="1"/>
            </xs:all>
        </xs:complexType>
    </xs:schema>
요소 이름
설명
id
등록 코드 서비스에서 생성된 UUID
코드
등록 코드 서비스에서 생성한 등록 코드
요청자
요청자 ID
mvpd
Mvpd ID
생성됨
등록 코드 생성 타임스탬프(1970년 1월 1일 GMT 이후 밀리초)
만료
등록 코드가 만료되는 타임스탬프(1970년 1월 1일 GMT 이후 밀리초)
deviceId
고유 장치 ID(또는 XSTS 토큰)
deviceType
장치 유형
deviceUser
사용자가 장치에 로그인함
appId
애플리케이션 ID
appVersion
응용 프로그램 버전
registrationURL
최종 사용자에게 표시될 로그인 웹 앱의 URL

오류 메시지 XSD error-message

    <?xml version="1.0" encoding="UTF-8"?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="rest.pass.adobe.com"
               targetNamespace="rest.pass.adobe.com"
               attributeFormDefault="unqualified"
               elementFormDefault="unqualified">
        <xs:element name="error">
            <xs:complexType>
                <xs:all>
                    <xs:element name="status" type="xs:int" minOccurs="1" maxOccurs="1"/>
                    <xs:element name="message" type="xs:string" minOccurs="1" maxOccurs="1"/>
                    <xs:element name="details" type="xs:string" minOccurs="0" maxOccurs="1"/>
                </xs:all>
            </xs:complexType>
        </xs:element>
    </xs:schema>

샘플 응답 sample-response

XML:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ns2:regcode xmlns:ns2="model.mvc.reggie.pass.adobe.com">
        <id>678f9fea-a1cafec8-1ff0-4a26-8564-f6cd020acf13</id>
        <code>TJJCFK</code>
        <requestor>sampleRequestorId</requestor>
        <mvpd>sampleMvpdId</mvpd>
        <generated>1348039846647</generated>
        <expires>1348043446647</expires>
        <info>
            <deviceId>dGhpc0lkQUR1bW15RGV2aWNlSWQ=</deviceId>
            <deviceType>xbox</deviceType>
            <deviceUser>JD</deviceUser>
            <appId>2345</appId>
            <appVersion>2.0</appVersion>
            <registrationURL>http://loginwebapp.com</registrationURL>
        </info>
    </ns2:regcode>

JSON:

    {
        "id": "678f9fea-9d364b29-246c-488f-b97e-298566d1b9e0",
        "code": "D4BDU2W",
        "requestor": "sampleRequestorId",
        "mvpd": "sampleMvpdId",
        "generated": 1348039555877,
        "expires": 1348043155877,
        "info": {
            "deviceId": "dGhpc0l.kQUR1bW15RGV2.aWNlSWQ=",
            "deviceType": "xboxOne",
            "deviceUser": "JD",
            "appId": "2345",
            "appVersion": "2.0",
            "registrationURL": "http://loginwebapp.com"
        }
    }
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b