1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
# -------------------------------------------------------------------------
# Copyright (c) Microsoft Corporation. All rights reserved.
# Licensed under the MIT License. See License.txt in the project root for
# license information.
# --------------------------------------------------------------------------
"""
FILE: user_credential_sample.py
DESCRIPTION:
These samples demonstrate creating a `CommunicationTokenCredential` object.
The `CommunicationTokenCredential` object is used to authenticate a user with Communication Services,
such as Chat or Calling. It optionally provides an auto-refresh mechanism to ensure a continuously
stable authentication state during communications.
USAGE:
python user_credential_sample.py
Set the environment variables with your own values before running the sample:
1) COMMUNICATION_SAMPLES_CONNECTION_STRING - the connection string in your Communication Services resource
"""
import os
from azure.communication.chat import CommunicationTokenCredential
from azure.communication.identity import CommunicationIdentityClient
class CommunicationTokenCredentialSamples(object):
connection_string = os.environ.get("COMMUNICATION_SAMPLES_CONNECTION_STRING", None)
if not connection_string:
raise ValueError("Set COMMUNICATION_SAMPLES_CONNECTION_STRING env before running this sample.")
identity_client = CommunicationIdentityClient.from_connection_string(connection_string)
user = identity_client.create_user()
token_response = identity_client.get_token(user, scopes=["chat"])
token = token_response.token
def create_credential_with_static_token(self):
# For short-lived clients, refreshing the token upon expiry is not necessary
# and `CommunicationTokenCredential` may be instantiated with a static token.
with CommunicationTokenCredential(self.token) as credential:
token_response = credential.get_token()
print("Token issued with value: " + token_response.token)
def create_credential_with_refreshing_callback(self):
# Alternatively, for long-lived clients, you can create a `CommunicationTokenCredential` with a callback to renew tokens if expired.
# Here we assume that we have a function `fetch_token_from_server` that makes a network request to retrieve a token string for a user.
# It's necessary that the `fetch_token_from_server` function returns a valid token (with an expiration date set in the future) at all times.
fetch_token_from_server = lambda: None
with CommunicationTokenCredential(self.token, token_refresher=fetch_token_from_server) as credential:
token_response = credential.get_token()
print("Token issued with value: " + token_response.token)
def create_credential_with_proactive_refreshing_callback(self):
# Optionally, you can enable proactive token refreshing where a fresh token will be acquired as soon as the
# previous token approaches expiry. Using this method, your requests are less likely to be blocked to acquire a fresh token
fetch_token_from_server = lambda: None
with CommunicationTokenCredential(
self.token, token_refresher=fetch_token_from_server, proactive_refresh=True
) as credential:
token_response = credential.get_token()
print("Token issued with value: " + token_response.token)
def clean_up(self):
print("cleaning up: deleting created user.")
self.identity_client.delete_user(self.user)
if __name__ == "__main__":
sample = CommunicationTokenCredentialSamples()
sample.create_credential_with_static_token()
sample.create_credential_with_refreshing_callback()
sample.create_credential_with_proactive_refreshing_callback()
sample.clean_up()
|
