REST API - översikt rest-api-overview
Ökning over
Adobe Pass Authentication REST API ger direktåtkomst till TVE-autentiserings- och auktoriseringstjänsterna (TV Everywhere). Detta API har stöd för två primära arkitekturer: server-till-server eller anslutna enheter (t.ex. spelkonsoler, smarta TV-apparater, digitalboxar) program som inte har webbläsarfunktioner.
Begränsningsmekanism
REST-API:t för Adobe Pass-autentisering styrs av en begränsningsmekanism.
Server-till-server
Server-till-server-lösningar omfattar program för programmeringsklienter som integreras med programmeringstjänster som ansluter till Adobe Pass autentiseringstjänster för TVE-flöden. Detta arbetssätt flyttar de flesta TVE-implementeringar från klienten till servern där en enda, enhetlig autentiseringsmodul kan skapas och underhållas. Klientprogrammets primära återstående ansvar är hanteringen av en webbvy för användarautentisering.
Anslutna enheter
Appar för anslutna enheter kommunicerar direkt med Adobe Pass Authentication via REST API:er för att utföra konfigurations-, registrerings-, autentiseringsstatuskontroller och auktoriseringsflöden, medan en andra skärmapp (webbläsarapp) krävs för autentiseringsflödet. Inbyggda SDK:er används därför inte.
Övriga arkitekturer
Förutom de två primära REST API-baserade arkitekturerna, server-till-server- och Direct-klientlösningarna för smarta enheter, finns det andra arkitekturer. Bland dem finns SDK-arkitekturen, som använder en klientkomponent som kallas Access Enabler och som Adobe Pass Authentication tillhandahåller programmerare. Appen använder API:er för åtkomstaktivering för att hantera start, autentisering, auktorisering och utloggning. All kommunikation mellan programmerarens app och Adobe Pass-autentiseringsservrarna sker via Access Enabler. En annan variant av Access Enabler finns för följande plattformar: JavaScript, iOS, tvOS, Android och FireTV.
Även om det är möjligt att använda REST API direkt på klientplattformar som stöder systemspecifika SDK:er utanför en Server-to-Server-lösning, rekommenderas inte detta.
REST API-proffs och Cons ProsAndCons
Adobe Pass Authentication REST API skapades för att tillhandahålla en TV Everywhere-lösning (TVE) för enheter som inte har webbläsarfunktioner eller beständig lagring. REST API har stöd för alla autentiserings- och auktoriseringsflöden, men eftersom det saknas en systemspecifik SDK-komponent. De SDK:er som tillhandahålls och underhålls av Adobe Pass Authentication har färdiga funktioner som implementerar affärsregler som måste implementeras och underhållas av programmerarna i händelse av REST API. I tabellen nedan beskriver vi de begränsningar i REST API som programmerare måste ta itu med.
Server-till-server jämfört med klientbaserade proffs och kontors
En Server-till-Server-arkitektur är ett sätt att konsolidera merparten av den autentiserings- och auktoriseringsrelaterade logiken i en enda logisk enhet eller implementering. Det här tillvägagångssättet har fördelar och nackdelar. Yrkesverksamma inom följande områden:
- En enda implementering för autentisering och auktorisering av affärslogik.
- Undvik behovet av att implementera logiken på alla plattformar som stöds med plattformens inbyggda verktyg.
- Möjlighet att uppdatera funktioner utan att behöva uppdatera klienter med alla tillhörande krav (t.ex. uppdateringar av appbutiker).
- Enklare - utöka och anpassa funktionerna för authN och authZ (t.ex. lägg till D2C).
- Direkt hantering av tillhörande trafik för bättre kontroll, kvalitet och övervakning.
Även här anges konerna i programmerarens ansvarsområden, men omfattar följande:
- SSO måste implementeras för varje klient för plattformar utan enkel inloggning.
- Programmerarna måste vid behov implementera MVPD-specifik logik.
- Alla plattformar som använder REST API delar en enda konfiguration som styr egenskaper som till exempel autentiserings-TTL:er.
Anslutna enheter
För de flesta anslutna enheter måste REST API användas på ett eller annat sätt eftersom en SDK inte är tillgänglig. Den anslutna enheten använder antingen REST API direkt eller integreras med en Server-till-Server-lösning som använder REST API.
Programmerarnas ansvar programmer-responsibilities
Följande gäller för både Server-to-Server- och Connected Device-program.
-
Som en del av vårt nya One API-initiativ planerar vi att åtgärda den här begränsningen och att kunna tillämpa regler per plattform baserat på enhetsidentifieringen.
-
Adobe fortsätter att arbeta med alla större plattformar för att implementera enkel inloggning för plattformen som kan användas med vårt REST API. Vårt One API-initiativ kommer att erbjuda SSO-stöd mellan appar som implementeras med systemspecifika SDK:er och appar som implementeras med REST API.
Lägsta enhetskrav min_reqs
För att du ska kunna använda Adobe Pass Authentication REST API måste enheterna uppfylla eller överskrida de lägsta tekniska kraven som anges i REST API-avsnittet i Adobe Pass Authentication Platform/Device/Tools Requirements document.