DokumentationAdobe PassAdobe Pass-autentisering

Stöd för SFSafariViewController i iOS SDK 3.2+ sfsafariviewcontroller-support-on-ios-sdk-3.2

Last update: Mon Jul 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Innehållet på den här sidan tillhandahålls endast i informationssyfte. Användning av denna API kräver en aktuell licens från Adobe. Ingen obehörig användning är tillåten.

På grund av säkerhetskrav MÅSTE vissa MVPD-inloggningssidor presenteras i en SFSafariViewController i stället för i webbvyer.

Vissa MVPD-program kräver att deras inloggningssidor visas i en säker webbläsarkontroll som SFSafariViewController. De blockerar aktivt webbvyer, så för att kunna autentisera med dem måste vi använda SVC.

Kompatibilitet compatiblity

Från och med iOS SDK version 3.1 visar AccessEnabler SDK automatiskt inloggningssidan för specifika MVPD:er i en SFSafariViewController, baserat på serverkonfigurationen.

Version 3.1 av SDK visar automatiskt SFSafariViewController från programmets rotvykontroll. Detta förenklar hanteringen av inloggningssidor för implementerare, men det finns fall där det inte är möjligt att presentera SFSafariViewController från rotvystyrenheten på grund av att appens specialiseringsimplementering (som en modal styrenhet som redan är synlig).

I sådana fall ger version 3.2 programmeraren möjlighet att hantera SVC manuellt.

Manuell SVC-hantering manual-svc-management

För att manuellt kunna hantera SVC måste implementeraren utföra följande steg:

  1. anropa setOptions(["handleSVC":true]) efter initiering av AccessEnabler (kontrollera att anropet utförs innan autentiseringen börjar). Detta aktiverar"manuell" SVC-hantering, SDK visar inte automatiskt SVC, utan vid behov kommer anropa navigate(toUrl:{url} useSVC:true).

  2. implementera det valfria återanropet navigateToUrl:useSVC: i implementeringen måste du skapa en svc-instans med SFSafariViewController-instansen med den angivna url:en och visa den på skärmen:

    code language-obj-c 
    func navigate(toUrl url: String!, useSVC: Bool) {
    svc =  SFSafariViewController(url: URL(string: url)!)
    svc.delegate = self
    myController.present(svc, animated: true)
    }

    Anteckningar:

    • Du kan anpassa SFSafariViewController precis som du vill. På iOS 11+ kan du till exempel ändra etiketten Klar till Avbryt.
    • Om du vill kunna avvisa SVC:n behöver du en referens till den. Skapa den inte inom omfånget navigateToUrl:useSVC
    • använd din egen vykontroll för "myController"

  3. I programdelegatimplementeringen av application(_app: UIApplication, öppna url: URL, alternativ: [UIApplicationOpenURLOptionsKey: Any]) -> Bool, lägg till kod för att stänga svc. Du bör redan ha kod där som anropar accessEnabler.handleExternalURL(). Lägg till nedan:

    code language-obj-c 
    if(svc != nil) {
    svc.dismiss(animated: true)
}

    Även här är svc en referens till den SFSafariViewController som du skapade i steg 2.

  4. Implementera safariViewControllerDoFinish(_-kontrollant: SFSafariViewController) från SFSafariViewControllerDelegate för att fånga när användaren avbröt SVC med hjälp av knappen Klar. I den här funktionen måste du anropa följande för att informera SDK om att autentiseringen har avbrutits:

    code language-obj-c 
    accessEnabler.setSelectedProvider(nil)
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b