Rychlý start: Přihlášení uživatelů a volání rozhraní Microsoft Graph API z aplikace pro iOS nebo macOS
Vítejte! Pravděpodobně to není stránka, kterou jste očekávali. Zatímco pracujeme na opravě, měl by vás tento odkaz dostat na správný článek:
Rychlý start: Přihlášení uživatelů a volání Microsoft Graphu z aplikace pro iOS nebo macOS
Omlouváme se za nepříjemnosti a vážíme si vaší trpělivosti, zatímco pracujeme na vyřešení tohoto problému.
V tomto rychlém startu si stáhnete a spustíte ukázku kódu, která předvádí, jak může nativní aplikace pro iOS nebo macOS přihlásit uživatele a získat přístupový token pro volání rozhraní Microsoft Graph API.
Rychlý start platí pro aplikace pro iOS i macOS. Některé kroky jsou potřeba jenom pro aplikace pro iOS a budou označeny jako takové.
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- XCode 10+
- iOS 10+
- macOS 10.12+
Jak ukázka funguje
Krok 1: Konfigurace aplikace
Aby ukázka kódu pro tento rychlý start fungovala, přidejte identifikátor URI přesměrování kompatibilní s zprostředkovatelem ověřování.
Vaše aplikace je nakonfigurovaná s těmito atributy.
Krok 2: Stažení ukázkového projektu
Krok 3: Instalace závislostí
- Extrahujte soubor zip.
- V okně terminálu přejděte do složky s ukázkou staženého kódu a spusťte
pod installinstalaci nejnovější knihovny MSAL.
Krok 4: Aplikace je nakonfigurovaná a připravená ke spuštění
Nakonfigurovali jsme váš projekt s hodnotami vlastností vaší aplikace a je připravený ke spuštění.
Poznámka:
Enter_the_Supported_Account_Info_Here
Pokud vytváříte aplikaci pro národní cloudy Microsoft Entra, nahraďte řádek začínající na let kGraphEndpoint a let kAuthority správnými koncovými body. Pro globální přístup použijte výchozí hodnoty:
let kGraphEndpoint = "https://graph.microsoft.com/" let kAuthority = "https://login.microsoftonline.com/common"Tady jsou popsané další koncové body. Pokud chcete například spustit rychlý start s Microsoft Entra Germany, použijte následující:
let kGraphEndpoint = "https://graph.microsoft.de/" let kAuthority = "https://login.microsoftonline.de/common"Otevřete nastavení projektu. V části Identita zadejte identifikátor sady, který jste zadali na portálu.
Klikněte pravým tlačítkem na Soubor Info.plist a vyberte Otevřít jako>zdrojový kód.
V kořenovém uzlu diktování nahraďte
Enter_the_bundle_Id_HereID sady, které jste použili na portálu.msauth.Všimněte si předpony v řetězci.<key>CFBundleURLTypes</key> <array> <dict> <key>CFBundleURLSchemes</key> <array> <string>msauth.Enter_the_Bundle_Id_Here</string> </array> </dict> </array>Sestavte a spusťte aplikaci.
Další informace
Další informace o tomto rychlém startu najdete v následujících částech.
Získání knihovny MSAL
MSAL (MSAL.framework) je knihovna, která slouží k přihlašování uživatelů a vyžádání tokenů používaných pro přístup k rozhraní API chráněnému platformou Microsoft Identity Platform. Knihovnu MSAL můžete do své aplikace přidat následujícím způsobem:
$ vi Podfile
Do tohoto souboru podfile přidejte následující položky (s cílem projektu):
use_frameworks!
target 'MSALiOS' do
pod 'MSAL'
end
Spusťte instalační příkaz CocoaPods:
pod install
Inicializace knihovny MSAL
Odkaz na knihovnu MSAL můžete přidat tak, že přidáte následující kód:
import MSAL
Potom inicializujte knihovnu MSAL pomocí následujícího kódu:
let authority = try MSALAADAuthority(url: URL(string: kAuthority)!)
let msalConfiguration = MSALPublicClientApplicationConfig(clientId: kClientID, redirectUri: nil, authority: authority)
self.applicationContext = try MSALPublicClientApplication(configuration: msalConfiguration)
Kde: Popis clientIdID aplikace z aplikace zaregistrované na webu portal.azure.com authorityPlatforma Microsoft Identity Platform. Ve většině případů to bude https://login.microsoftonline.com/common>redirectUriIdentifikátor URI přesměrování aplikace. Pokud chcete použít výchozí hodnotu, můžete předat hodnotu nil nebo vlastní identifikátor URI přesměrování.
Pouze pro iOS další požadavky na aplikace
Ve vaší AppDelegateaplikaci musí být také následující. To umožňuje sadě MSAL SDK zpracovat odpověď tokenu z aplikace zprostředkovatele ověřování při ověřování.
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
return MSALPublicClientApplication.handleMSALResponse(url, sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String)
}
Poznámka:
Pokud v iOSu 13+, místo toho tento UIApplicationDelegateUISceneDelegate kód nasadíte do zpětného scene:openURLContexts: volání (viz dokumentace společnosti Apple).
Pokud podporujete jak UISceneDelegate, tak UIApplicationDelegate kvůli kompatibilitě se starším iOSem, musí být zpětné volání MSAL umístěné na obou místech.
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
guard let urlContext = URLContexts.first else {
return
}
let url = urlContext.url
let sourceApp = urlContext.options.sourceApplication
MSALPublicClientApplication.handleMSALResponse(url, sourceApplication: sourceApp)
}
Aplikace musí mít LSApplicationQueriesSchemes v souboru Info.plist položku vedle CFBundleURLTypessouboru . Součástí této ukázky je i tato ukázka.
<key>LSApplicationQueriesSchemes</key>
<array>
<string>msauthv2</string>
<string>msauthv3</string>
</array>
Přihlášení uživatelů a vyžádání tokenů
Knihovna MSAL používá k získání tokenů dvě metody: acquireToken a acquireTokenSilent.
acquireToken: Interaktivní získání tokenu
Některé situace vyžadují, aby uživatelé komunikovali s platformou Microsoft Identity Platform. V těchto případech může být koncový uživatel nutný k výběru svého účtu, zadání přihlašovacích údajů nebo souhlasu s oprávněními vaší aplikace. Příklad:
- Při prvním přihlášení k aplikaci
- Pokud uživatel resetuje heslo, bude muset zadat svoje přihlašovací údaje.
- Když aplikace žádá o přístup k prostředku poprvé
- Pokud se vyžadují vícefaktorové ověřování nebo jiné zásady podmíněného přístupu
let parameters = MSALInteractiveTokenParameters(scopes: kScopes, webviewParameters: self.webViewParamaters!)
self.applicationContext!.acquireToken(with: parameters) { (result, error) in /* Add your handling logic */}
Kde: Popis scopesObsahuje požadované obory (to znamená [ "user.read" ]pro Microsoft Graph nebo[ "<Application ID URL>/scope" ]pro vlastní webová rozhraní API (api://<Application ID>/access_as_user)).
acquireTokenSilent: Bezobslužné získání přístupového tokenu
Aplikace by neměly vyžadovat, aby se uživatelé při každém vyžádání tokenu přihlásili. Pokud se uživatel už přihlásil, tato metoda umožňuje aplikacím bezobslužně požadovat tokeny.
self.applicationContext!.getCurrentAccount(with: nil) { (currentAccount, previousAccount, error) in
guard let account = currentAccount else {
return
}
let silentParams = MSALSilentTokenParameters(scopes: self.kScopes, account: account)
self.applicationContext!.acquireTokenSilent(with: silentParams) { (result, error) in /* Add your handling logic */}
}
Kde: Popis scopesObsahuje požadované obory (to znamená [ "user.read" ]pro Microsoft Graph nebo[ "<Application ID URL>/scope" ]pro vlastní webová rozhraní API (api://<Application ID>/access_as_user).accountPro účet se požaduje token. Tento rychlý start se týká jedné aplikace účtu. Pokud chcete vytvořit aplikaci s více účty, budete muset definovat logiku pro identifikaci účtu, který se má použít pro žádosti o tokeny pomocí accountsFromDeviceForParameters:completionBlock:a předání správných chyb.accountIdentifier
Nápověda a podpora
Pokud potřebujete pomoc, chcete nahlásit problém nebo se chcete dozvědět o možnostech podpory, přečtěte si nápovědu a podporu pro vývojáře.
Další kroky
Přejděte k podrobnému kurzu, ve kterém vytvoříte aplikaci pro iOS nebo macOS, která získá přístupový token z platformy Microsoft Identity Platform a použije ho k volání rozhraní Microsoft Graph API.