Azure Communication Identity Package client library for Python¶
Azure Communication Identity client package is intended to be used to setup the basics for opening a way to use Azure Communication Service offerings. This package helps to create identity user tokens to be used by other client packages such as chat, calling, sms.
Python 2.7, or 3.6 or later is required to use this package.
You must have an Azure subscription
A deployed Communication Services resource. You can use the Azure Portal or the Azure PowerShell to set it up. ### Install the package Install the Azure Communication Identity client library for Python with pip:
pip install azure-communication-identity
CommunicationIdentityClient provides operations for:
Create/delete identities to be used in Azure Communication Services. Those identities can be used to make use of Azure Communication offerings and can be scoped to have limited abilities through token scopes.
Create/revoke scoped user access tokens to access services such as chat, calling, sms. Tokens are issued for a valid Azure Communication identity and can be revoked at any time.
Initializing Identity Client¶
# You can find your endpoint and access token from your resource in the Azure Portal import os from azure.communication.identity import CommunicationIdentityClient from azure.identity import DefaultAzureCredential connection_str = "endpoint=ENDPOINT;accessKey=KEY" endpoint = "https://<RESOURCE_NAME>.communication.azure.com" # To use Azure Active Directory Authentication (DefaultAzureCredential) make sure to have # AZURE_TENANT_ID, AZURE_CLIENT_ID and AZURE_CLIENT_SECRET as env variables. identity_client_managed_identity = CommunicationIdentityClient(endpoint, DefaultAzureCredential()) #You can also authenticate using your connection string identity_client = CommunicationIdentityClient.from_connection_string(connection_str)
The following section provides several code snippets covering some of the most common Azure Communication Services tasks, including:
Creating a new user¶
create_user method to create a new user.
user = identity_client.create_user() print("User created with id:" + user.properties['id'])
Issuing or Refreshing an access token for a user¶
get_token method to issue or refresh a scoped access token for the user. Pass in the user object as a parameter, and a list of
CommunicationTokenScope. Scope options are:
tokenresponse = identity_client.get_token(user, scopes=[CommunicationTokenScope.CHAT]) print("Token issued with value: " + tokenresponse.token)
Creating a user and a token in a single request¶
For convenience, use
create_user_and_token to create a new user and issue a token with one function call. This translates into a single web request as opposed to creating a user first and then issuing a token.
user, tokenresponse = identity_client.create_user_and_token(scopes=[CommunicationTokenScope.CHAT]) print("User id:" + user.properties['id']) print("Token issued with value: " + tokenresponse.token)
Revoking a user’s access tokens¶
revoke_tokens to revoke all access tokens for a user. Pass in the user object as a parameter
Deleting a user¶
delete_user method to delete a user. Pass in the user object as a parameter
Exchanging AAD access token of a Teams User for a Communication Identity access token¶
get_token_for_teams_user method to exchange an AAD access token of a Teams User for a new Communication Identity access token.
The Azure Communication Service Identity client will raise exceptions defined in Azure Core.
Please take a look at the samples directory for detailed examples of how to use this library to manage identities and tokens.
If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.