Riferimento API per iOS/tvOS SDK iostvos-sdk-api-reference

Introduzione intro

Questa pagina descrive i metodi e le funzioni di callback esposti dal client nativo iOS/tvOS per l’autenticazione di Adobe Pass. I metodi e le funzioni di callback qui descritti sono definiti nel AccessEnabler.h e EntitlementDelegate.h file di intestazione; li puoi trovare nell’SDK di iOS AccessEnabler qui: [SDK directory]/AccessEnabler/headers/api/

Documentazione associata:

Riferimento API apis

init:softwareStatement initWithSoftwareStatement

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Crea istanze dell'oggetto AccessEnabler. Deve essere presente una singola istanza di AccessEnabler per ogni istanza dell'applicazione.

Disponibilità: v3.0+

Parametri:

Torna all'inizio…

init - [OBSOLETO] init

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Crea istanze dell'oggetto AccessEnabler. Deve essere presente una singola istanza di AccessEnabler per ogni istanza dell'applicazione.

Disponibilità: v1.0+ Fino a: v3.0

Parametri: Nessuno

Torna all'inizio…

setOptions:opzioni setOptions

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Configura le opzioni SDK globali. Accetta un NSDictionary come argomento. I valori del dizionario vengono passati al server insieme a ogni chiamata di rete effettuata dall'SDK.

Nota: I valori vengono passati al server indipendentemente dal flusso corrente (autenticazione/autorizzazione). Se desideri modificare i valori, puoi chiamare questo metodo in qualsiasi momento.

Disponibilità: v2.3.0+

Parametri:

Torna all'inizio…

setRequestor:requestorID, setRequestor:requestorID:serviceProviders: setReqV3

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Stabilisce l'identità del programmatore. A ciascun programmatore viene assegnato un ID univoco al momento della registrazione all’Adobe per il sistema di autenticazione di Adobe Pass. Quando si tratta di token SSO e remoti, lo stato di autenticazione può cambiare quando l'applicazione è in background, setRequestor può essere richiamato nuovamente quando l'applicazione viene portata in primo piano per sincronizzarsi con lo stato del sistema (recuperare un token remoto se SSO è abilitato o eliminare il token locale se nel frattempo si è verificato un logout).

La risposta del server contiene un elenco di MVPD insieme ad alcune informazioni di configurazione collegate all'identità del programmatore. La risposta del server viene utilizzata internamente dal codice AccessEnabler. Solo lo stato dell’operazione (ovvero OPERAZIONE RIUSCITA/NON RIUSCITA) viene presentato all’applicazione tramite setRequestorComplete: callback.

Se il urls non viene utilizzato, la chiamata di rete risultante è destinata all’URL predefinito del fornitore di servizi: l’ambiente Adobe RELEASE/production.

Se per il campo urls , la chiamata di rete risultante esegue il targeting di tutti gli URL forniti nel urls parametro. Tutte le richieste di configurazione vengono attivate contemporaneamente in thread separati. Il primo responder ha la precedenza quando si compila l’elenco degli MVPD. Per ogni MVPD nell'elenco, AccessEnabler ricorda l'URL del provider di servizi associato. Tutte le richieste di adesione successive vengono indirizzate all’URL associato al provider di servizi che è stato associato all’MVPD di destinazione durante la fase di configurazione.

Disponibilità: v3.0+

Disponibilità: v3.0+

Parametri:

Callback attivati: setRequestorComplete:

Torna all'inizio…

setRequestor:setSignedRequestorId:, setRequestor:setSignedRequestorId:serviceProviders: - [OBSOLETO] setReq

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Stabilisce l'identità del programmatore. A ciascun programmatore viene assegnato un ID univoco al momento della registrazione all’Adobe per il sistema di autenticazione di Adobe Pass. Quando si tratta di token SSO e remoti, lo stato di autenticazione può cambiare quando l'applicazione è in background, setRequestor può essere richiamato nuovamente quando l'applicazione viene portata in primo piano per sincronizzarsi con lo stato del sistema (recuperare un token remoto se SSO è abilitato o eliminare il token locale se nel frattempo si è verificato un logout).

La risposta del server contiene un elenco di MVPD insieme ad alcune informazioni di configurazione collegate all'identità del programmatore. La risposta del server viene utilizzata internamente dal codice AccessEnabler. Solo lo stato dell’operazione (ovvero OPERAZIONE RIUSCITA/NON RIUSCITA) viene presentato all’applicazione tramite setRequestorComplete: callback.

Se il urls non viene utilizzato, la chiamata di rete risultante è destinata all’URL predefinito del fornitore di servizi: l’ambiente Adobe RELEASE/production.

Se per il campo urls , la chiamata di rete risultante esegue il targeting di tutti gli URL forniti nel urls parametro. Tutte le richieste di configurazione vengono attivate contemporaneamente in thread separati. Il primo responder ha la precedenza quando si compila l’elenco degli MVPD. Per ogni MVPD nell'elenco, AccessEnabler ricorda l'URL del provider di servizi associato. Tutte le richieste di adesione successive vengono indirizzate all’URL associato al provider di servizi che è stato associato all’MVPD di destinazione durante la fase di configurazione.

Disponibilità: v1.0+ Fino a: v3.0

Disponibilità: v1.0+ Fino a: v3.0

Parametri:

Note: Se chiamato senza serviceProviders , la libreria recupererà la configurazione dal provider di servizi predefinito (ovverohttps://sp.auth.adobe.com per il profilo di produzione o https://sp.auth-staging.adobe.com per il profilo di staging). Se il serviceProviders fornito, deve essere un array di URL. Le informazioni di configurazione vengono recuperate da tutti gli endpoint specificati e unite. Se esistono informazioni duplicate in risposte diverse del provider di servizi, il conflitto viene risolto a favore del server con la risposta più rapida (ovvero, il server con il tempo di risposta più breve ha la precedenza).

Callback attivati: setRequestorComplete:

Torna all'inizio…

setRequestor:setSignedRequestorId:secret:publicKey, setRequestor:setSignedRequestorId:serviceProviders:secret:publicKey - [OBSOLETO] setReq_tvos

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Stabilisce l'identità del programmatore. A ciascun programmatore viene assegnato un ID univoco al momento della registrazione all’Adobe per il sistema di autenticazione di Adobe Pass. Questa impostazione deve essere eseguita una sola volta durante il ciclo di vita dell'applicazione.

La risposta del server contiene un elenco di MVPD insieme ad alcune informazioni di configurazione collegate all'identità del programmatore. La risposta del server viene utilizzata internamente dal codice AccessEnabler. Solo lo stato dell’operazione (ovvero OPERAZIONE RIUSCITA/NON RIUSCITA) viene presentato all’applicazione tramite setRequestorComplete: callback.

Se il urls non viene utilizzato, la chiamata di rete risultante è destinata all’URL predefinito del fornitore di servizi: l’ambiente Adobe RELEASE/production.

Se per il campo urls , la chiamata di rete risultante esegue il targeting di tutti gli URL forniti nel urls parametro. Tutte le richieste di configurazione vengono attivate contemporaneamente in thread separati. Il primo responder ha la precedenza quando si compila l’elenco degli MVPD. Per ogni MVPD nell'elenco, AccessEnabler ricorda l'URL del provider di servizi associato. Tutte le richieste di adesione successive vengono indirizzate all’URL associato al provider di servizi che è stato associato all’MVPD di destinazione durante la fase di configurazione.

- (void) setRequestor:(NSString *)requestorID
    signedRequestorID:(NSString *)signedRequestorID
               secret:(NSString *)secret
            publicKey:(NSString *)publicKey;

Disponibilità: v2.0+ Fino a: v3.0

- (void) setRequestor:(NSString *)requestorID
    signedRequestorID:(NSString *)signedRequestorID
     serviceProviders:(NSArray *)urls

Disponibilità: v2.0+ Fino a: v3.0

Parametri:

Se chiamato senza serviceProviders , la libreria recupererà la configurazione dal provider di servizi predefinito (ad esempio, https://sp.auth.adobe.com per il profilo di produzione o https://sp.auth-staging.adobe.com per il profilo di staging). Se il serviceProviders fornito, deve essere un array di URL. Le informazioni di configurazione vengono recuperate da tutti gli endpoint specificati e unite. Se esistono informazioni duplicate in risposte diverse del provider di servizi, il conflitto viene risolto a favore del server con la risposta più rapida (ovvero, il server con il tempo di risposta più breve ha la precedenza).

Callback attivati: setRequestorComplete:

Torna all'inizio…

setRequestorComplete: setReqComplete

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler che informa l'applicazione del completamento della fase di configurazione. Questo è un segnale che l’app può iniziare a emettere richieste di adesione. L’applicazione non può inviare richieste di adesione fino al completamento della fase di configurazione.

- (void) setRequestorComplete:(int)status;

Disponibilità: v1.0+

Parametri:

Attivato da:

setRequestor:setSignedRequestorId:, setRequestor:setSignedRequestorId:serviceProviders:

Torna all'inizio…

checkAuthentication checkAuthN

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Controlla lo stato di autenticazione dell'utente corrente.
A tale scopo, cerca un token di autenticazione valido nello spazio di archiviazione dei token locale. Questo metodo non esegue chiamate di rete e si consiglia di chiamarlo sul thread principale.
Viene utilizzata dall’applicazione per eseguire una query sullo stato di autenticazione dell’utente e aggiornare di conseguenza l’interfaccia utente (ad esempio, aggiornare l’interfaccia utente di accesso/disconnessione). Lo stato di autenticazione viene comunicato all’applicazione tramite setAuthenticationStatus:errorCode: callback.

- (void) checkAuthentication;

Disponibilità: v1.0+

Parametri: Nessuno

Callback attivati:
setAuthenticationStatus:errorCode:

Torna all'inizio…

getAuthentication, getAuthentication:withData: getAuthN

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Avvia il flusso di lavoro di autenticazione completo. Viene avviato controllando lo stato di autenticazione. Se non è già autenticato, viene avviato il computer dello stato del flusso di autenticazione:

Poiché le credenziali dell'utente vengono verificate nella pagina di accesso MVPD, l'applicazione deve monitorare le operazioni di reindirizzamento multiple che si verificano mentre l'utente si autentica nella pagina di accesso di MVPD. Quando vengono immesse le credenziali corrette, il controllo WebView viene reindirizzato a un URL personalizzato definito da ADOBEPASS_REDIRECT_URL costante. Questo URL non deve essere caricato da WebView. L’applicazione deve intercettare questo URL e interpretare questo evento come un segnale del completamento della fase di accesso. Deve quindi passare il controllo ad AccessEnabler per completare il flusso di autenticazione (chiamando il handleExternalURL metodo).

Infine, lo stato di autenticazione viene comunicato all’applicazione tramite setAuthenticationStatus:errorCode: callback.

- (void) getAuthentication;

Disponibilità: v1.0+

- (void) getAuthentication:(BOOL)forceAuthn:
                  withData:(NSDictionary* )data;

Disponibilità: v1.9+

Parametri:

Callback attivati: setAuthenticationStatus:errorCode:, displayProviderDialog:, sendTrackingData:forEventType:

Torna all'inizio…

getAuthentication:filter, getAuthentication:withData:andFilter getAuthN_filter

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Avvia il flusso di lavoro di autenticazione completo. Viene avviato controllando lo stato di autenticazione. Se non è già autenticato, viene avviato il computer dello stato del flusso di autenticazione:

Infine, lo stato di autenticazione viene comunicato all’applicazione tramite setAuthenticationStatus:errorCode: callback.

Disponibilità: v2.4+

- (void) getAuthentication:(NSDictionary *)filter;

- (void) getAuthentication:(BOOL)forceAuthn:
                  withData:(NSDictionary* )data
                 andFilter:(NSDictionary *)filter;

Parametri:

Disponibilità: v2.0 - v2.3.1

- (void) getAuthentication:(NSArray *)filter;

- (void) getAuthentication:(BOOL)forceAuthn:
                  withData:(NSDictionary* )data
                 andFilter:(NSArray *)filter;

Parametri:

Callback attivati: setAuthenticationStatus:errorCode:, presentTvProviderDialog, dismissTvProviderDialog

Torna all'inizio…

displayProviderDialog: dispProvDialog

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler per informare l'applicazione che è necessario creare un'istanza degli elementi dell'interfaccia utente appropriati per consentire all'utente di selezionare l'MVPD desiderato. Il callback fornisce un elenco di oggetti MVPD con informazioni aggiuntive che possono aiutare a creare correttamente il pannello dell'interfaccia utente di selezione (come l'URL che punta al logo MVPD, il nome visualizzato intuitivo, ecc.)

Dopo che l’utente ha selezionato l’MVPD desiderato, l’applicazione di livello superiore deve riprendere il flusso di autenticazione chiamando setSelectedProvider: e trasmettendogli l’ID del MVPD corrispondente alla selezione dell’utente.

Interruzione del flusso di autenticazione - Questo è un punto in cui l’utente ha la possibilità di premere il pulsante "Indietro", che equivale all’interruzione del flusso di autenticazione. In questo caso, l’applicazione deve chiamare setSelectedProvider: , passando null come parametro, per consentire ad AccessEnabler di reimpostare il computer dello stato di autenticazione.

- (void) displayProviderDialog:(NSArray *)mvpds;

Disponibilità: v1.0+

Parametri:

Attivato da: getAuthentication, getAuthentication:withData:,getAuthorization:, getAuthorization:withData:

Torna all'inizio…

setSelectedProvider: setSelProv

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Questo metodo viene richiamato dall'applicazione per informare l'Access Enabler della selezione MVPD dell'utente. È possibile utilizzare questo metodo per selezionare o modificare il provider di servizi utilizzato per l'autenticazione.

Se l’MVPD selezionato è un MVPD TempPass, si autenticherà automaticamente con tale MVPD senza dover chiamare in seguito getAuthentication().

Tieni presente che questo non è possibile per il Passaggio temporaneo promozionale in cui vengono forniti parametri aggiuntivi sul metodo getAuthentication().

Quando si passa nulle come parametro, Access Enabler presuppone che l’utente abbia annullato il flusso di autenticazione (ovvero premuto il pulsante "Indietro") e risponde reimpostando lo stato-computer di autenticazione e chiamando setAuthenticationStatus:errorCode: callback con AccessEnabler.PROVIDER_NOT_SELECTED_ERROR codice di errore.

- (void) setSelectedProvider:(NSString *)mvpdId;

Disponibilità: v1.0+

Parametri: Nessuno

Callback attivati: setAuthenticationStatus:errorCode:,sendTrackingData:forEventType:, navigateToUrl:

Torna all'inizio…

navigateToUrl: nav2url

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione: Callback attivato da AccessEnabler per richiedere all'applicazione di creare un'istanza di un controller UIWebView/WKWebView e di caricare l'URL fornito nel url parametro. Il callback passa il url Parametro che rappresenta l'URL dell'endpoint di autenticazione o l'URL dell'endpoint di logout.

Come UIWebView/WKWebView il controller passa attraverso diversi reindirizzamenti, l'applicazione deve monitorare l'attività del controller e rilevare il momento in cui carica un URL personalizzato specifico definito dal ADOBEPASS_REDIRECT_URL costante (ovvero adobepass://ios.app). Questo URL personalizzato specifico non è valido e non è destinato al controller per caricarlo effettivamente. Deve essere interpretato solo dall'applicazione come un segnale che il flusso di autenticazione o disconnessione è stato completato e che è sicuro chiudere il controller. Quando il controller carica questo URL personalizzato specifico, l'applicazione deve chiudere UIWebView/WKWebView e chiamare AccessEnabler handleExternalURL:url metodo API.

Nota: Tieni presente che nel caso del flusso di autenticazione si tratta di un punto in cui l’utente ha la possibilità di premere il pulsante "Indietro", che equivale all’interruzione del flusso di autenticazione. In questo caso, l’applicazione deve chiamare setSelectedProvider: metodo di passaggio nil come parametro e dando la possibilità ad AccessEnabler di reimpostare il computer dello stato di autenticazione.

- (void) navigateToUrl:(NSString *)url;

Disponibilità: v1.0+

Parametri:

Attivato da: setSelectedProvider:

Torna all'inizio…

navigateToUrl:useSVC: nav2urlSVC

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione: Callback attivato da AccessEnabler anziché da navigateToUrl: callback nel caso in cui l'applicazione abbia precedentemente abilitato la gestione manuale di Safari View Controller (SVC) tramite setOptions(["handleSVC":true"]) e solo in caso di MVPD che richiedono Safari View Controller (SVC). Per tutti gli altri MVPD navigateToUrl: verrà chiamato il callback. ConsultaSupporto di SFSafariViewController sull'SDK iOS 3.2+ per informazioni dettagliate sulla gestione di Safari View Controller (SVC).

Simile a navigateToUrl: callback di navigateToUrl:useSVC: viene attivato da AccessEnabler per richiedere all'applicazione di creare un'istanza di SFSafariViewController e per caricare l'URL fornito nel file del callback url parametro. Il callback passa il url parametro che rappresenta l'URL dell'endpoint di autenticazione o l'URL dell'endpoint di logout e useSVC parametro che specifica che l'applicazione deve utilizzare un SFSafariViewController.

Come SFSafariViewController il controller viene sottoposto a diversi reindirizzamenti; l'applicazione deve monitorare l'attività del controller e rilevare il momento in cui carica un URL personalizzato specifico definito dal application's custom scheme (ad es.**​ **adbe.u-XFXJeTSDuJiIQs0HVRAg://adobe.com). Questo URL personalizzato specifico non è valido e non è destinato al controller per caricarlo effettivamente. Deve essere interpretato solo dall'applicazione come un segnale che il flusso di autenticazione o disconnessione è stato completato e che è sicuro chiudere il controller. Quando il controller carica questo URL personalizzato specifico, l'applicazione deve chiudere SFSafariViewController e chiama AccessEnabler handleExternalURL:url metodo API.

Nota: Tieni presente che nel caso del flusso di autenticazione si tratta di un punto in cui l’utente ha la possibilità di premere il pulsante "Indietro", che equivale all’interruzione del flusso di autenticazione. In questo caso, l’applicazione deve chiamare setSelectedProvider: metodo di passaggio nil come parametro e dando la possibilità ad AccessEnabler di reimpostare il computer dello stato di autenticazione.

@optional
​- (void) navigateToUrl:(NSString *)url useSVC:(BOOL)useSVC;

Disponibilità: ​v 3.2+

Parametri:

Attivato da: ​ setOptions: prima di setSelectedProvider:

Torna all'inizio…

handleExternalURL:url handleExternalURL

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Questo metodo viene richiamato dall'applicazione per completare il flusso di autenticazione o disconnessione. Questo metodo deve essere chiamato subito dopo che l'applicazione rileva il momento in cui UIWebView/WKWebView or SFSafariViewController il controller viene reindirizzato a un URL personalizzato specifico. Nel caso in cui l’applicazione debba utilizzare un SFSafariViewController controller l'URL personalizzato specifico è definito dal application's custom scheme (ad es.adbe.u-XFXJeTSDuJiIQs0HVRAg://adobe.com), altrimenti questo URL personalizzato specifico è definito da ADOBEPASS_REDIRECT_URL costante (ovvero adobepass://ios.app).

Nel caso del flusso di autenticazione, AccessEnabler completa il flusso recuperando il token di autenticazione dal server back-end e archiviandolo localmente nell'archivio dei token. AccessEnabler informerà l'applicazione che il flusso di autenticazione è completo chiamando setAuthenticationStatus() callback con codice di stato 1, che indica l'esito positivo. Se si verifica un errore durante l'esecuzione di questi passaggi, il setAuthenticationStatus() il callback viene attivato con un codice di stato pari a 0, che indica un errore di autenticazione, nonché un codice di errore corrispondente.

 (void) handleExternalURL:(NSString *)url;

Disponibilità: v3.0+

Parametri:

Callback attivati: setAuthenticationStatus:errorCode, sendTrackingData:forEventType:

Torna all'inizio…

getAuthenticationToken - [OBSOLETO] getAuthNToken

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Completa il flusso di autenticazione richiedendo il token di autenticazione dal server back-end. Questo metodo deve essere chiamato dall'applicazione solo in risposta all'evento in cui il controllo WebView che ospita la pagina di accesso MVPD viene reindirizzato all'URL personalizzato definito da ADOBEPASS_REDIRECT_URL costante.

- (void) getAuthenticationToken;

Disponibilità: v1.0+ Fino a: v3.0

Parametri: Nessuno

Callback attivati: setAuthenticationStatus:errorCode,sendTrackingData:forEventType:

Torna all'inizio…

</br

setAuthenticationStatus:errorCode: setAuthNStatus

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler che informa l'applicazione dello stato del flusso di autenticazione. In molti casi questo flusso può non riuscire, a causa dell’interazione dell’utente o di altri scenari imprevisti (ad esempio, problemi di connettività di rete, ecc.). Questo callback informa l’applicazione dello stato di esito positivo/negativo del flusso di autenticazione, fornendo al contempo informazioni aggiuntive sul motivo dell’errore, quando necessario.

- (void) setAuthenticationStatus:(int)status
                       errorCode:(NSString *)code;

Disponibilità: v1.0+

Parametri:

Attivato da: checkAuthentication, getAuthentication, getAuthentication:withData:, checkAuthorization:, checkAuthorization:withData:

Torna all'inizio…

checkPreauthorizedResources: checkPreauth

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Questo metodo viene utilizzato dall’applicazione per determinare se l’utente è già autorizzato a visualizzare risorse protette specifiche. Lo scopo principale di questo metodo è quello di recuperare informazioni da utilizzare per decorare l’interfaccia utente (ad esempio, per indicare lo stato di accesso con le icone di blocco e sblocco).

- (void) checkPreauthorizedResources:(NSArray *)resources;

Disponibilità: v1.3+

Parametri:

Callback attivato: preauthorizedResources:

Torna all'inizio…

checkPreauthorizedResources:cache: checkPreauthCache

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Questo metodo viene utilizzato dall’applicazione per determinare se l’utente è già autorizzato a visualizzare risorse protette specifiche. Lo scopo principale di questo metodo è quello di recuperare informazioni da utilizzare per decorare l’interfaccia utente (ad esempio, per indicare lo stato di accesso con le icone di blocco e sblocco). Il cache Il parametro controlla se la cache interna viene utilizzata per la risoluzione delle risorse.

- (void) checkPreauthorizedResources:(NSArray *)resources cache:(BOOL)cache;

Disponibilità: v3.1+

Parametri:

Callback attivato: preauthorizedResources:

Torna all'inizio…

risorse preautorizzate: preauthResources

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione: Callback attivato da checkPreauthorizedResources:. Fornisce un elenco delle risorse che l’utente è già autorizzato a visualizzare.

- (void) checkPreauthorizedResources:(NSArray *)resources;

Disponibilità: v1.3+

Parametri:

Attivato da: checkPreauthorizedResources:

Torna all'inizio…

checkAuthorization:, checkAuthorization:withData: checkAuthZ

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Questo metodo viene utilizzato dall'applicazione per controllare lo stato di autorizzazione. Viene innanzitutto verificato lo stato di autenticazione. Se non autenticato, il tokenRequestFailed:errorCode:errorDescription: viene attivato il callback e il metodo viene chiuso. Se l’utente è autenticato, attiva anche il flusso di autorizzazione. Vedi i dettagli su getAuthorization: metodo.

- (void) checkAuthorization:(NSString *)resource;

Disponibilità: v1.0+

- (void) checkAuthorization:(NSString *)resource:
                   withData:(NSDictionary *)data;

Disponibilità: v1.9+

Parametri:

Callback attivati:

tokenRequestFailed:errorCode:errorDescription:,setToken:forResource:, sendTrackingData:forEventType:, setAuthenticationStatus:errorCode:

Torna all'inizio…

getAuthorization:, getAuthorization:withData: getAuthZ

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Questo metodo viene utilizzato dall'applicazione per avviare il flusso di autorizzazione. Se l’utente non è già autenticato, avvia anche il flusso di autenticazione. Se l'utente viene autenticato, AccessEnabler procede con il rilascio di richieste per il token di autorizzazione (se non è presente alcun token di autorizzazione valido nella cache dei token locale) e per il token multimediale di breve durata. Una volta ottenuto il token multimediale breve, il flusso di autorizzazione viene considerato completo. Il setToken:forResource: il callback viene attivato e il token multimediale breve viene distribuito come parametro all’applicazione. Se, per qualsiasi motivo, l'autorizzazione non riesce, il tokenRequestFailed:forEventType: viene attivato il callback e vengono forniti il codice di errore o i dettagli.

- (void) getAuthorization:(NSString *)resource;

Disponibilità: v1.0+

- (void) getAuthorization:(NSString *)resource:
                 withData:(NSDictionary *)data;

Disponibilità: v1.9+

Parametri:

Callback attivati: tokenRequestFailed:errorCode:errorDescription:, setToken:forResource:,sendTrackingData:forEventType:

Callback aggiuntivi attivati:
Questo metodo può anche attivare i seguenti callback (se viene avviato anche il flusso di autenticazione): setAuthenticationStatus:errorCode:, displayProviderDialog:

Torna all'inizio…

setToken:forResource: setToken

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler che informa l'applicazione che il flusso di autorizzazione è stato completato correttamente. Anche il token multimediale di breve durata viene distribuito come parametro.

- (void) setToken:(NSString *)token
      forResource:(NSString *)resource;

Disponibilità: v1.0+

Parametri:

Attivato da: checkAuthorization: , checkAuthorization:withData:, getAuthorization:, getAuthorization:withData:

Torna all'inizio…

tokenRequestFailed:errorCode:errorDescription: tokenReqFailed

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler che informa l'applicazione di livello superiore che il flusso di autorizzazione non è riuscito.

- (void) tokenRequestFailed:(NSString *)resource
                  errorCode:(NSString *)code
           errorDescription:(NSString *)description;

Disponibilità: v1.0+

Parametri:

Attivato da: checkAuthorization:, checkAuthorization:withData:, getAuthorization:, getAuthorization:withData:

Torna all'inizio…

logout logout

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Questo metodo viene richiamato dall'applicazione per avviare il flusso di logout. La disconnessione è il risultato di una serie di operazioni di reindirizzamento HTTP dovute al fatto che l’utente deve essere disconnesso sia dai server di autenticazione di Adobe Pass che dai server MVPD. Poiché questo flusso non può essere completato con una semplice richiesta HTTP emessa dalla libreria AccessEnabler, è possibile che UIWebView/WKWebView or SFSafariViewController è necessario creare un'istanza del controller per poter seguire le operazioni di reindirizzamento HTTP.

Il flusso di logout è diverso dal flusso di autenticazione in quanto l’utente non è tenuto a interagire con UIWebView/WKWebView or SFSafariViewController in qualsiasi modo. Pertanto, Adobe consiglia di rendere il controllo invisibile (ovvero nascosto) durante la procedura di disconnessione.

Viene utilizzato un modello simile al flusso di autenticazione. IOS AccessEnabler attiva navigateToUrl: callback o navigateToUrl:useSVC: per creare un UIWebView/WKWebView or SFSafariViewController e per caricare l'URL fornito nel file del callback url parametro. Questo è l'URL dell'endpoint di disconnessione sul server back-end. Per tvOS AccessEnabler né il navigateToUrl: callback o navigateToUrl:useSVC: chiamata di callback.

Durante il trattamento di diversi reindirizzamenti, l’applicazione deve monitorare l’attività del UIWebView/WKWebView or SFSafariViewController e rilevare il momento in cui carica un URL personalizzato specifico. Questo URL personalizzato specifico non è valido e non è destinato al controller per caricarlo effettivamente. Deve essere interpretato solo dall'applicazione come un segnale che il flusso di logout è stato completato e che è sicuro chiudere il controller. Quando il controller carica questo URL personalizzato specifico, l'applicazione deve chiudere il controller e chiamare AccessEnabler handleExternalURL:url metodo API. Nel caso in cui l’applicazione debba utilizzare un SFSafariViewController controller l'URL personalizzato specifico è definito dal application's custom scheme (ad es.adbe.u-XFXJeTSDuJiIQs0HVRAg://adobe.com), altrimenti questo URL personalizzato specifico è definito da ADOBEPASS_REDIRECT_URL costante (ovvero adobepass://ios.app).

Alla fine AccessEnabler chiamerà setAuthenticationStatus() callback con codice di stato 0, che indica il completamento del flusso di logout.

Nota: Se l'utente ha effettuato l'accesso con Apple SSO, verrà attivato lo stato di VSA203. In questo caso, l'utente deve essere informato di disconnettersi anche dalle impostazioni di sistema. In caso contrario, verrà eseguita una nuova autenticazione al riavvio dell'applicazione.

- (void) logout;

Disponibilità: v1.0+

Parametri: Nessuno

Callback attivati: navigateToUrl:, setAuthenticationStatus:errorCode:

Torna all'inizio…

getSelectedProvider getSelProv

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Utilizzare questo metodo per determinare il provider attualmente selezionato.

- (void) getSelectedProvider;

Disponibilità: v1.0+

Parametri: Nessuno

Callback attivati: selectedProvider:

Torna all'inizio…

selectedProvider selProv

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler che fornisce all'applicazione informazioni sull'MVPD attualmente selezionato.

- (void) selectedProvider:(MVPD *)mvpd;

Disponibilità: v1.0+

Parametri:

Attivato da: getSelectedProvider

Torna all'inizio…

getMetadata: getMeta

File: AccessEnabler/headers/AccessEnabler.h

Descrizione: Utilizzare questo metodo per recuperare informazioni esposte come metadati dalla libreria AccessEnabler. L’applicazione può accedere a questi dati fornendo un dizionario chiave parametro di input.

Esistono due tipi di metadati disponibili per i programmatori:

- (void) getMetadata:(NSDictionary *)keyDictionary;

Disponibilità: v1.0+

Parametri:

Callback attivati: setMetadataStatus:encrypted:forKey:andArguments:

Ulteriori informazioni: Metadati utente

Torna all'inizio…

presentTVProviderDialog presentTvDialog

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler dopo la chiamatagetAuthentication() se il richiedente corrente supporta almeno un MVPD con supporto SSO.

- (void) presentTvProviderDialog: (UIViewController *) viewController;

Disponibilità: v2.0+

Parametri:

Attivato da: getAuthentication

Ulteriori informazioni: iOS/tvOS Single Sign On

Torna all'inizio…

dismissTVProviderDialog dismissTvDialog

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler dopo la chiusura della finestra di dialogo SSO di Apple.

- (void) dismissTvProviderDialog: (UIViewController *) viewController;

Disponibilità: v2.0+

Parametri:

Attivato da: Azione utente

Ulteriori informazioni: iOS/tvOS Single Sign On

Torna all'inizio…

setMetadataStatus:encrypted:forKey:andArguments: setMetaStatus

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato da AccessEnabler che distribuisce i metadati richiesti tramite un getMetadata: chiamare.

- (void) setMetadataStatus:(id)metadata
                 encrypted:(bool)encrypted
                    forKey:(int)key
              andArguments:(NSDictionary *)arguments;

Disponibilità: v1.0+

Parametri:

        {
            updated: 1334243471,
            encrypted: ["encryptedProp"],
            data: {
                zip: ["12345", "34567"],
                maxRating: {
                    "MPAA": "PG-13",
                    "VCHIP": "TV-Y",
                    "URL": "http://exam.pl/e/manage/ratings"
                },
                householdID: "3456",
                userID: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=",
                channelID: ["channel-1", "channel-2"]
            }

Attivato da: getMetadata:

Ulteriori informazioni: Metadati utente

Torna all'inizio…

MVPD mvpd

File: AccessEnabler/headers/model/MVPD.h

Descrizione Descrive l'oggetto MVPD. Può essere utilizzato per ottenere informazioni sulle proprietà dell'MVPD.

Disponibilità: v1.0+ [La proprietà boardingStatus è disponibile dalla versione 2.2]

Proprietà:

Torna all'inizio…

Tracciamento degli eventi tracking

AccessEnabler attiva un callback aggiuntivo non necessariamente correlato ai flussi di adesione. Implementazione di sendTrackingData() la funzione di callback è facoltativa, ma consente all'applicazione di tenere traccia di eventi specifici e di compilare statistiche quali il numero di tentativi di autenticazione/autorizzazione riusciti/non riusciti.

sendTrackingData sendTracking

File: AccessEnabler/headers/EntitlementDelegate.h

Descrizione Callback attivato dal segnale di AccessEnabler all'applicazione al verificarsi di vari eventi come il completamento/il fallimento dei flussi di autenticazione/autorizzazione. Con Adobe Pass Authentication 1.6, il tipo di dispositivo, il tipo di client AccessEnabler e il sistema operativo vengono segnalati da sendTrackingData(). Il sendTrackingData() il callback rimane compatibile con le versioni precedenti.

Callback: eventi di tracciamento

(void) sendTrackingData:(NSArray *)data
             forEventType:(int)event;

Disponibilità: v1.0+

Nota: Il tipo di dispositivo e il sistema operativo sono derivati tramite l'uso di una libreria Java pubblica (http://java.net/projects/user-agent-utils) e la stringa dell'agente utente. Tieni presente che queste informazioni vengono fornite solo come metodo grezzo per suddividere le metriche operative in categorie di dispositivi, ma che l’Adobe non può assumersi alcuna responsabilità per risultati errati. Utilizza la nuova funzionalità di conseguenza.

Parametri:

Attivato da: checkAuthentication, getAuthentication, getAuthentication:withData:, checkAuthorization:, checkAuthorization:withData:, getAuthorization:, getAuthorization:withData:, setSelectedProvider:

Istruzioni per l’interpretazione dei valori in dati array: