CommunicationIdentityClient class
Clientklasse für die Interaktion mit Azure Communication Services Benutzertokenverwaltung.
Konstruktoren
Communication |
Initialisiert eine neue Instanz der CommunicationIdentity-Klasse. |
Communication |
Initialisiert eine neue Instanz der CommunicationIdentity-Klasse mit azure KeyCredential. |
Communication |
Initialisiert eine neue Instanz der CommunicationIdentity-Klasse mit tokenCredential. |
Methoden
create |
Erstellt einen einzelnen Benutzer. |
create |
Erstellt einen einzelnen Benutzer und ein Token gleichzeitig. |
delete |
Löst das Sperrereignis für den Benutzer aus und löscht alle zugehörigen Daten. |
get |
Erstellt ein bereichsbezogenes Benutzertoken. |
get |
Tauscht ein Azure AD-Zugriffstoken eines Teams-Benutzers gegen ein neues Kommunikationsidentitäts-Zugriffstoken mit einer übereinstimmenden Ablaufzeit aus. |
revoke |
Widerruft alle Daten und Token, die für einen Benutzer erstellt wurden. |
Details zum Konstruktor
CommunicationIdentityClient(string, CommunicationIdentityClientOptions)
Initialisiert eine neue Instanz der CommunicationIdentity-Klasse.
new CommunicationIdentityClient(connectionString: string, options?: CommunicationIdentityClientOptions)
Parameter
- connectionString
-
string
Verbindungszeichenfolge zum Herstellen einer Verbindung mit einer Azure Communication Service-Ressource. Beispiel: "endpoint=https://contoso.eastus.communications.azure.net/;accesskey=secret";
Optional. Optionen zum Konfigurieren der HTTP-Pipeline.
CommunicationIdentityClient(string, KeyCredential, CommunicationIdentityClientOptions)
Initialisiert eine neue Instanz der CommunicationIdentity-Klasse mit azure KeyCredential.
new CommunicationIdentityClient(endpoint: string, credential: KeyCredential, options?: CommunicationIdentityClientOptions)
Parameter
- endpoint
-
string
Der Endpunkt des Diensts (z. B. https://contoso.eastus.communications.azure.net).
- credential
-
KeyCredential
Ein Objekt, das zum Authentifizieren von Anforderungen beim Dienst verwendet wird. Verwenden Sie azureKeyCredential oder @azure/identity
zum Erstellen von Anmeldeinformationen.
Optional. Optionen zum Konfigurieren der HTTP-Pipeline.
CommunicationIdentityClient(string, TokenCredential, CommunicationIdentityClientOptions)
Initialisiert eine neue Instanz der CommunicationIdentity-Klasse mit tokenCredential.
new CommunicationIdentityClient(endpoint: string, credential: TokenCredential, options?: CommunicationIdentityClientOptions)
Parameter
- endpoint
-
string
Der Endpunkt des Diensts (z. B. https://contoso.eastus.communications.azure.net).
- credential
-
TokenCredential
Ein Objekt, das zum Authentifizieren von Anforderungen beim Dienst verwendet wird. Verwenden Sie azureKeyCredential oder @azure/identity
zum Erstellen von Anmeldeinformationen.
Optional. Optionen zum Konfigurieren der HTTP-Pipeline.
Details zur Methode
createUser(OperationOptions)
Erstellt einen einzelnen Benutzer.
function createUser(options?: OperationOptions): Promise<CommunicationUserIdentifier>
Parameter
- options
-
OperationOptions
Zusätzliche Optionen für die Anforderung.
Gibt zurück
Promise<CommunicationUserIdentifier>
createUserAndToken(TokenScope[], CreateUserAndTokenOptions)
Erstellt einen einzelnen Benutzer und ein Token gleichzeitig.
function createUserAndToken(scopes: TokenScope[], options?: CreateUserAndTokenOptions): Promise<CommunicationUserToken>
Parameter
- scopes
Bereiche, die in das Token eingeschlossen werden sollen.
- options
- CreateUserAndTokenOptions
Zusätzliche Optionen für die Anforderung.
Gibt zurück
Promise<CommunicationUserToken>
deleteUser(CommunicationUserIdentifier, OperationOptions)
Löst das Sperrereignis für den Benutzer aus und löscht alle zugehörigen Daten.
function deleteUser(user: CommunicationUserIdentifier, options?: OperationOptions): Promise<void>
Parameter
- user
-
CommunicationUserIdentifier
Der Benutzer, der gelöscht wird.
- options
-
OperationOptions
Zusätzliche Optionen für die Anforderung.
Gibt zurück
Promise<void>
getToken(CommunicationUserIdentifier, TokenScope[], GetTokenOptions)
Erstellt ein bereichsbezogenes Benutzertoken.
function getToken(user: CommunicationUserIdentifier, scopes: TokenScope[], options?: GetTokenOptions): Promise<CommunicationAccessToken>
Parameter
- user
-
CommunicationUserIdentifier
Der Benutzer, dessen Token ausgegeben werden.
- scopes
Bereiche, die in das Token eingeschlossen werden sollen.
- options
- GetTokenOptions
Zusätzliche Optionen für die Anforderung.
Gibt zurück
Promise<CommunicationAccessToken>
getTokenForTeamsUser(GetTokenForTeamsUserOptions)
Tauscht ein Azure AD-Zugriffstoken eines Teams-Benutzers gegen ein neues Kommunikationsidentitäts-Zugriffstoken mit einer übereinstimmenden Ablaufzeit aus.
function getTokenForTeamsUser(options: GetTokenForTeamsUserOptions): Promise<CommunicationAccessToken>
Parameter
- options
- GetTokenForTeamsUserOptions
Optionen zum Austauschen eines Azure AD-Zugriffstokens eines Teams-Benutzers gegen ein neues Kommunikationsidentitäts-Zugriffstoken.
Gibt zurück
Promise<CommunicationAccessToken>
revokeTokens(CommunicationUserIdentifier, OperationOptions)
Widerruft alle Daten und Token, die für einen Benutzer erstellt wurden.
function revokeTokens(user: CommunicationUserIdentifier, options?: OperationOptions): Promise<void>
Parameter
- user
-
CommunicationUserIdentifier
Der Benutzer, dessen Token widerrufen werden.
- options
-
OperationOptions
Zusätzliche Optionen für die Anforderung.
Gibt zurück
Promise<void>