Scambio metadati contenuti MVPD

NOTE
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente da Adobe. Non è consentito alcun uso non autorizzato.

Panoramica content-metadat-exchange-overview

Questa pagina descrive due implementazioni standard utilizzate dall’autenticazione di Adobe Pass per inviare dati strutturati agli MVPD nella richiesta di autorizzazione. I dati strutturati rappresentano la risorsa (il Programmatore) che effettua la richiesta ed eventualmente dati aggiuntivi, come la valutazione del contenuto.

Sul lato Programmatore, l’autenticazione Adobe Pass supporta risorse di dati MRSS strutturate come segue:

  1. Il programmatore invia la risorsa come stringa MRSS. L’autenticazione Adobe Pass non la codifica sul lato client per dispositivi web o nativi. Il servizio MRSS viene inviato come stringa regolare al server di autenticazione di Adobe Pass.

  2. Sul lato server, MRSS viene convalidato in base allo schema predefinito (http://search.yahoo.com/mrss/). Se la convalida viene superata, Adobe Pass Authentication estrae le informazioni dai campi MRSS, tra cui:

    • titolo canale
    • titolo elemento
    • identificatore di risorsa
    • valore e tipo di valutazione
  3. I valori estratti dal sistema MRSS vengono utilizzati per creare la richiesta di autorizzazione che viene passata al MVPD.

L’autenticazione Adobe Pass supporta due approcci per tradurre il sistema MRSS in formati supportati dagli MVPD:

  • XACML Il primo approccio è allineato allo standard OLCA. Utilizza XACML, in cui i valori MRSS vengono estratti per creare una risorsa XACMLR con attributi mappati agli elementi MRSS. Questo viene quindi passato al MVPD.
  • RESTO. Il secondo approccio è basato su REST. MRSS è codificato in base64 e trasmesso come parametro URL nella chiamata REST.

In entrambi gli approcci, MVPD elabora la richiesta di autorizzazione includendo i valori estratti nel proprio flusso logico e restituendo una risposta di autorizzazione.

Dettagli dell’integrazione integration-details

  • Risorsa strutturata XML basata su OLCA
  • Risorsa strutturata basata su REST

Risorsa strutturata XML basata su OLCA olca-based-xacml-struc-resource

La maggior parte degli MVPD orientati ai cavi utilizza l'approccio basato su XACML, ma non supporta ancora l'approccio completo ai dati strutturati. Altri MVPD che supportano XACML accettano il titolo del canale e accettano quello per l'attributo ResourceID. L’esempio seguente mostra l’approccio completamente strutturato basato su XACML. Il team di autenticazione di Adobe Pass consiglia agli MVPD che utilizzano XACML ma non supportano ancora funzioni come il controllo genitori di adattare la propria integrazione XACML all’esempio seguente:

<?xml version="1.0" encoding="UTF-8"?>
<soap11:Envelope xmlns:soap11=">
    <soap11:Header/>
    <soap11:Body>
        <xacml-samlp:XACMLAuthzDecisionQuery
                xmlns:xacml-samlp="urn:oasis:names:tc:xacml:2.0:profile:saml2.0:v2:schema:protocol"
                Destination="
                ID="_f1dd34469c5aeac016760e51dbba007d" IssueInstant="2012-06-26T16:30:24.879Z" Version="2.0">
            <saml:Issuer xmlns:saml="urn:oasis:names:tc:SAML:2.0:assertion">
                https://saml.sp.auth.adobe.com/
            </saml:Issuer>
            <ds:Signature xmlns:ds=">.......</ds:Signature>
            <xacml-context:Request xmlns:xacml-context="urn:oasis:names:tc:xacml:2.0:context:schema:os">
                [....info skipped for brevity....]
                <xacml-context:Resource>

        // The MRSS item GUID is passed as the XACML Resource resource-id
                    <xacml-context:Attribute AttributeId="urn:oasis:names:tc:xacml:1.0:resource:resource-id">
                        <xacml-context:AttributeValue>DISNEY_GUID_12345</xacml-context:AttributeValue>
                    </xacml-context:Attribute>
        // The MRSS channel title is passed as the XACML Resource tv-network
                    <xacml-context:Attribute AttributeId="urn:cablelabs:ocla:1.0:attribute:content:tv-network">
                        <xacml-context:AttributeValue>Disney</xacml-context:AttributeValue>
                    </xacml-context:Attribute>

        // Adobe doesn't yet support an explicit namespace for the GUID, so we reuse the channel title as the GUID.
        // We expect to add an explicit namespace later next year pulling it from the GUID scheme attribute.
                    <xacml-context:Attribute AttributeId="urn:cablelabs:ocla:1.0:attribute:content:id:namespace">
                        <xacml-context:AttributeValue>Disney</xacml-context:AttributeValue>
                    </xacml-context:Attribute>

        // The MRSS item title is passed as the XACML Resource content title
                    <xacml-context:Attribute AttributeId="urn:cablelabs:ocla:1.0:attribute:content:title">
                        <xacml-context:AttributeValue>Disney Program X</xacml-context:AttributeValue>
                    </xacml-context:Attribute>

        // The MRSS media rating is passed as the XACML Resource content rating
                    <xacml-context:Attribute AttributeId="urn:cablelabs:ocla:1.0:attribute:content:rating:vchip">
                        <xacml-context:AttributeValue>TV-Y</xacml-context:AttributeValue>
                    </xacml-context:Attribute>

                </xacml-context:Resource>

                <xacml-context:Action>
                    <xacml-context:Attribute>
                        <xacml-context:AttributeValue>VIEW</xacml-context:AttributeValue>
                    </xacml-context:Attribute>
                </xacml-context:Action>

                [.....info skipped for brevity....]
            </xacml-context:Request>
        </xacml-samlp:XACMLAuthzDecisionQuery>
    </soap11:Body>
</soap11:Envelope>

//formatted for readability

Risorsa strutturata basata su REST rest-based-struct-resource

Alcuni MVPD hanno standardizzato il seguente protocollo basato su REST per l'autorizzazione. Questo approccio è completo quanto l’approccio XACML, ma fornisce un’implementazione "più leggera".

// The MRSS is base64 encoded by Adobe Pass Authentication, and passed in that format to the REST-based Authorization endpoint.

https://auth.somedomain.net/mediation/1/rest/client/authz?uuID=AC82CE4&mrss=base64encodedstring&IPAddress=123.456.78.901

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b