Anleitung
Persona in Capacitor nutzen
Verwendung von @capgo/capacitor-intune
Capacitor Plugin für Microsoft Intune MAM-Enrollment, App-Schutzrichtlinien, App-Konfiguration und MSAL-Authentifizierung.
Installieren
bun add @capgo/capacitor-intune
bunx cap sync
bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.
Importieren
import { IntuneMAM } from '@capgo/capacitor-intune';
API auf einen Blick
| Methode | Beschreibung |
|---|---|
acquireToken |
Startet den Microsoft Sign-in-Flow und gibt ein Access Token sowie die Account-Metadaten zurück. |
acquireTokenSilent |
Ruft ein Token aus dem MSAL-Cache für einen bereits angemeldeten User ab. |
registerAndEnrollAccount |
Registriert ein zuvor authentifiziertes Konto bei Intune und startet das Enrollment. |
loginAndEnrollAccount |
Fordert Intune auf, einen User zu authentifizieren und zu enrollen, ohne vorher ein App-Token anzufordern. |
enrolledAccount |
Gibt das aktuell enrollte Intune-Konto zurück, sofern eines verfügbar ist. |
deRegisterAndUnenrollAccount |
Das Konto bei Intune abmelden und bei Bedarf einen selektiven Wipe auslösen. |
logoutOfAccount |
Meldet den Benutzer bei MSAL ab, ohne das Intune-Konto abzumelden. |
appConfig |
Ruft die Remote-Intune-Appkonfiguration für ein verwaltetes Konto ab. |
getPolicy |
Ruft die aktuell gültige Intune App Protection Policy für ein verwaltetes Konto ab. |
groupName |
Praktischer Helper, der den GroupName App-Konfigurationswert auflöst, falls vorhanden. |
sdkVersion |
Gibt die nativen Intune- und MSAL SDK Versionen zurück, die in diesem Plugin enthalten sind. |
displayDiagnosticConsole |
Zeigt die native Intune-Diagnose-UI an. |
Beispiele
acquireToken()
Startet den Microsoft Sign-in-Flow und gibt ein Access Token sowie die Account-Metadaten zurück.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireToken({ scopes: ['openid'] });
// The result holds sensitive values: use it without logging it.
acquireTokenSilent()
Ruft ein Token aus dem MSAL-Cache für einen bereits angemeldeten User ab.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.acquireTokenSilent({
scopes: ['openid'],
accountId: 'acquireToken',
});
// The result holds sensitive values: use it without logging it.
registerAndEnrollAccount()
Registriert ein zuvor authentifiziertes Konto bei Intune und startet das Enrollment.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.registerAndEnrollAccount({ accountId: 'account-id-123' });
loginAndEnrollAccount()
Fordert Intune auf, einen User zu authentifizieren und zu enrollen, ohne vorher ein App-Token anzufordern.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.loginAndEnrollAccount();
enrolledAccount()
Gibt das aktuell enrollte Intune-Konto zurück, sofern eines verfügbar ist.
import { IntuneMAM } from '@capgo/capacitor-intune';
const result = await IntuneMAM.enrolledAccount();
console.log(result);
deRegisterAndUnenrollAccount()
Das Konto bei Intune abmelden und bei Bedarf einen selektiven Wipe auslösen.
import { IntuneMAM } from '@capgo/capacitor-intune';
await IntuneMAM.deRegisterAndUnenrollAccount({ accountId: 'account-id-123' });
Die obige Tabelle listet die 12 Kernmethoden auf. Listener und Versions-Helper sowie der vollständige Contract jeder Methode sind dokumentiert in der GitHub Repository.
Events abonnieren
addListener gibt ein Handle zurück. Rufe handle.remove() auf, wenn der Screen unmountet, oder IntuneMAM.removeAllListeners() auf, um alle Listener zu entfernen.
Vollständige Referenz
Weiter mit @capgo/capacitor-intune
Wenn du es nutzt Verwendung von @capgo/capacitor-intune Um Authentifizierungs- und Account-Flows zu planen, verbinde es mit @capgo/capacitor-intune für die Implementierungsdetails in @capgo/capacitor-intune, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-social-login für die Implementierungsdetails in @capgo/capacitor-social-login, @capgo/capacitor-passkey für die Implementierungsdetails in @capgo/capacitor-passkey, und @capgo/capacitor-native-biometric für die Implementierungsdetails in @capgo/capacitor-native-biometric.