Guida introduttiva: Creare e gestire le risorse di Servizi di comunicazione

  • Articolo

Per iniziare a usare Servizi di comunicazione di Azure, effettuare il provisioning della prima risorsa di Servizi di comunicazione. È possibile effettuare il provisioning delle risorse di Servizi di comunicazione tramite il portale di Azure o con .NET Management SDK. L'SDK di gestione e il portale di Azure consentono di creare, configurare, aggiornare ed eliminare le risorse e l'interfaccia con Azure Resource Manager, il servizio di distribuzione e gestione di Azure. Tutte le funzioni disponibili negli SDK sono disponibili nella portale di Azure.

Avviso

Si noti che non è possibile creare un gruppo di risorse contemporaneamente a una risorsa per Servizi di comunicazione di Azure. Quando si crea una risorsa, è necessario usare un gruppo di risorse già creato.

Prerequisiti

Si noti che se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.

Creare una risorsa di Servizi di comunicazione di Azure

Per creare una risorsa di Servizi di comunicazione di Azure, accedere innanzitutto al portale di Azure. Nell'angolo superiore sinistro della pagina selezionare + Crea una risorsa.

Screenshot che illustra il pulsante Crea una risorsa nel portale di Azure.

Immettere Comunicazione in Cerca nel Marketplace o nella barra di ricerca nella parte superiore del portale.

Screenshot che illustra una ricerca di servizi di comunicazione nella barra di ricerca.

Selezionare Servizi di comunicazione nei risultati, quindi selezionare Crea.

Screenshot che mostra il pannello Servizi di comunicazione, evidenziando il pulsante Crea.

È ora possibile configurare la risorsa di Servizi di comunicazione. Nella prima pagina del processo di creazione verrà richiesto di specificare:

  • La sottoscrizione
  • Gruppo di risorse (è possibile crearne uno nuovo o scegliere un gruppo di risorse esistente)
  • Il nome della risorsa di Servizi di comunicazione
  • La geografia a cui verrà associata la risorsa

Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare i tag per organizzare le risorse di Azure. Per altre informazioni sui tag, vedere la documentazione relativa all'assegnazione di tag a una risorsa.

Infine, è possibile esaminare la configurazione e creare la risorsa. Si noti che il completamento della distribuzione richiederà alcuni minuti.

Gestire la risorsa di Servizi di comunicazione

Per gestire la risorsa di Servizi di comunicazione, passare al portale di Azure, cercare e selezionare Servizi di comunicazione di Azure.

Nella pagina Servizi di comunicazione selezionare il nome della risorsa.

La pagina Panoramica per la risorsa contiene le opzioni per la gestione di base, ad esempio Sfoglia, Arresta, Avvia, Riavvia ed Elimina. È possibile trovare altre opzioni di configurazione nel menu a sinistra della pagina della risorsa.

Prerequisiti

Se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.

Creare una risorsa di Servizi di comunicazione di Azure

Per creare una risorsa Servizi di comunicazione di Azure, accedere all'interfaccia della riga di comando di Azure. È possibile accedere eseguendo il az login comando dal terminale e specificando le credenziali. Eseguire il comando seguente per creare la risorsa:

az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup>"

Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.

az communication create --name "<acsResourceName>" --location "Global" --data-location "United States" --resource-group "<resourceGroup> --subscription "<subscriptionId>"

È possibile configurare la risorsa di Servizi di comunicazione con le opzioni seguenti:

  • Gruppo di risorse
  • Il nome della risorsa di Servizi di comunicazione
  • La geografia a cui verrà associata la risorsa

Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare i tag per organizzare le risorse di Azure. Per altre informazioni sui tag, vedere la documentazione relativa all'assegnazione di tag alle risorse.

Gestire la risorsa di Servizi di comunicazione

Per aggiungere tag alla risorsa di Servizi di comunicazione, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.

az communication update --name "<communicationName>" --tags newTag="newVal1" --resource-group "<resourceGroup>"

az communication update --name "<communicationName>" --tags newTag="newVal2" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

az communication show --name "<communicationName>" --resource-group "<resourceGroup>"

az communication show --name "<communicationName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Per informazioni su altri comandi, vedere Interfaccia della riga di comando di comunicazione di Azure.

Prerequisiti

Si noti che se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.

Installazione dell'SDK

In primo luogo, includere Communication Services Management SDK nel progetto C#:

using Azure.ResourceManager.Communication;

ID sottoscrizione

È necessario conoscere l'ID della sottoscrizione di Azure. Queste informazioni possono essere acquisite dal portale:

  1. Accedere all'account Azure
  2. Selezionare Sottoscrizioni nella barra laterale sinistra
  3. Selezionare la sottoscrizione necessaria
  4. Fare clic su Panoramica
  5. Selezionare l'ID sottoscrizione

In questo argomento di avvio rapido si presuppone che l'ID sottoscrizione sia stato archiviato in una variabile di ambiente denominata AZURE_SUBSCRIPTION_ID.

Autenticazione

Per comunicare con Servizi di comunicazione di Azure, è prima necessario eseguire l'autenticazione in Azure. Questa operazione viene in genere eseguita usando un'identità dell'entità servizio.

Opzione 1: Identità gestita

Se il codice è in esecuzione come servizio in Azure, il modo più semplice per eseguire l'autenticazione consiste nell'acquisire un'identità gestita da Azure. Vedere altre informazioni sulle identità gestite.

Servizi di Azure che supportano le identità gestite

Come usare le identità gestite nel servizio app e in Funzioni di Azure

Identità gestita assegnata dal sistema

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var acsClient = new CommunicationManagementClient(subscriptionId, new ManagedIdentityCredential());

Identità gestita assegnata dall'utente

Il parametro ClientID dell'identità gestita creata devono essere passato a ManagedIdentityCredential in modo esplicito.

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = "AZURE_SUBSCRIPTION_ID";
var managedIdentityCredential = new ManagedIdentityCredential("AZURE_CLIENT_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, managedIdentityCredential);

Opzione 2: Entità servizio

Invece di usare un'identità gestita, è possibile eseguire l'autenticazione in Azure usando un'entità servizio gestita in prima persona. Altre informazioni sull'uso della documentazione sulla creazione e la gestione di un'entità servizio in Microsoft Entra ID.

Dopo aver creato l'entità servizio, è necessario raccogliere dal portale di Azure le informazioni seguenti relative all'entità:

  • ID client
  • Segreto client
  • ID tenant

Archiviare questi valori rispettivamente nelle variabili di ambiente denominate AZURE_CLIENT_ID, AZURE_CLIENT_SECRET e AZURE_TENANT_ID. È quindi possibile creare un client di gestione di Servizi di comunicazione nel modo seguente:

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var acsClient = new CommunicationManagementClient(subscriptionId, new EnvironmentCredential());

Opzione 3: Identità utente

Se si vuole chiamare Azure per conto di un utente interattivo invece di usare un'identità del servizio, è possibile usare il codice seguente per creare un client di gestione di Servizi di comunicazione di Azure. Verrà aperta una finestra del browser per richiedere all'utente le credenziali msa o Microsoft Entra.

using Azure.Identity;
using Azure.ResourceManager.Communication;
using Azure.ResourceManager.Communication.Models;
using System;
...
var subscriptionId = Environment.GetEnvironmentVariable("AZURE_SUBSCRIPTION_ID");
var communicationServiceClient = new CommunicationManagementClient(subscriptionId, new InteractiveBrowserCredential());

Gestione delle risorse di Servizi di comunicazione

Interazione con le risorse di Azure

Dopo che è stata eseguita l'autenticazione, è possibile usare il client di gestione per effettuare chiamate API.

Per ognuno degli esempi seguenti, verranno assegnate risorse di Servizi di comunicazione a un gruppo di risorse esistente.

Se è necessario creare un gruppo di risorse, è possibile farlo usando il portale di Azure o Azure Resource Manager SDK.

Creare e gestire una risorsa di Servizi di comunicazione

L'istanza del client Communication Services Management SDK (Azure.ResourceManager.Communication.CommunicationManagementClient) può essere usata per eseguire operazioni sulle risorse di Servizi di comunicazione.

Creare una risorsa di Servizi di comunicazione

Quando si crea una risorsa di Servizi di comunicazione, è necessario specificare il nome del gruppo di risorse e il nome della risorsa. Si noti che la proprietà Location sarà sempre global e durante l'anteprima pubblica il valore di DataLocation deve essere UnitedStates.

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates"  };
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Aggiornare una risorsa di Servizi di comunicazione

...
var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var resource = new CommunicationServiceResource { Location = "Global", DataLocation = "UnitedStates" };
resource.Tags.Add("environment","test");
resource.Tags.Add("department","tech");
// Use existing resource name and new resource object
var operation = await acsClient.CommunicationService.StartCreateOrUpdateAsync(resourceGroupName, resourceName, resource);
await operation.WaitForCompletionAsync();

Elencare tutte le risorse di Servizi di comunicazione

var resources = acsClient.CommunicationService.ListBySubscription();
foreach (var resource in resources)
{
    Console.WriteLine(resource.Name);
}

Eliminare una risorsa di Servizi di comunicazione

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
await acsClient.CommunicationService.StartDeleteAsync(resourceGroupName, resourceName);

Gestione delle chiavi e delle stringhe di connessione

Ogni risorsa di Servizi di comunicazione ha una coppia di chiavi di accesso e le corrispondenti stringhe di connessione. È possibile accedere a queste chiavi con Management SDK e quindi usare altri SDK di Servizi di comunicazione per eseguire l'autenticazione a Servizi di comunicazione di Azure.

Ottenere le chiavi di accesso per una risorsa di Servizi di comunicazione

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keys = await acsClient.CommunicationService.ListKeysAsync(resourceGroupName, resourceName);

Console.WriteLine(keys.Value.PrimaryConnectionString);
Console.WriteLine(keys.Value.SecondaryConnectionString);

Rigenerare una chiave di accesso per una risorsa di Servizi di comunicazione

var resourceGroupName = "myResourceGroupName";
var resourceName = "myResource";
var keyParams = new RegenerateKeyParameters { KeyType = KeyType.Primary };
var keys = await acsClient.CommunicationService.RegenerateKeyAsync(resourceGroupName, resourceName, keyParams);

Console.WriteLine(keys.Value.PrimaryKey);

Prerequisiti

Si noti che se si prevede di usare i numeri di telefono, non è possibile usare l'account di valutazione gratuita. Verificare che la sottoscrizione soddisfi tutti i requisiti se si prevede di acquistare numeri di telefono prima di creare la risorsa.

Creare una risorsa di Servizi di comunicazione di Azure

Per creare una risorsa Servizi di comunicazione di Azure, accedere all'interfaccia della riga di comando di Azure. È possibile eseguire questa operazione tramite il terminale usando il Connect-AzAccount comando e specificando le credenziali.

Prima di tutto, assicurarsi di installare il modulo Az.Communication Servizi di comunicazione di Azure usando il comando seguente.

PS C:\> Install-Module Az.Communication

Eseguire il comando seguente per creare la risorsa:

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global

Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.

PS C:\> New-AzCommunicationService -ResourceGroupName ContosoResourceProvider1 -Name ContosoAcsResource1 -DataLocation UnitedStates -Location Global -SubscriptionId SubscriptionID

È possibile configurare la risorsa di Servizi di comunicazione con le opzioni seguenti:

  • Gruppo di risorse
  • Il nome della risorsa di Servizi di comunicazione
  • La geografia a cui verrà associata la risorsa

Nel passaggio successivo è possibile assegnare tag alla risorsa. È possibile usare i tag per organizzare le risorse di Azure. Per altre informazioni sui tag, vedere la documentazione relativa all'assegnazione di tag a una risorsa.

Gestire la risorsa di Servizi di comunicazione

Per aggiungere tag alla risorsa di Servizi di comunicazione, eseguire i comandi seguenti. È anche possibile specificare come destinazione una sottoscrizione specifica.

PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"}

PS C:\> Update-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1 -Tag @{ExampleKey1="ExampleValue1"} -SubscriptionId SubscriptionID

Per elencare tutte le risorse Servizi di comunicazione di Azure in una determinata sottoscrizione, usare il comando seguente:

PS C:\> Get-AzCommunicationService -SubscriptionId SubscriptionID

Per elencare tutte le informazioni su una determinata risorsa, usare il comando seguente:

PS C:\> Get-AzCommunicationService -Name ContosoAcsResource1 -ResourceGroupName ContosoResourceProvider1

Accedere alle stringhe di connessione e agli endpoint di servizio

le stringhe di Connessione ion consentono agli SDK di Servizi di comunicazione di connettersi ed eseguire l'autenticazione in Azure. È possibile accedere alle stringhe di connessione e agli endpoint di servizio di Servizi di comunicazione dal portale di Azure o a livello di codice con le API di Azure Resource Manager.

Dopo aver eseguito il passaggio alla risorsa di Servizi di comunicazione, selezionare Chiavi dal menu di spostamento e copiare la stringa di Connessione ion o i valori endpoint per l'utilizzo da parte degli SDK di Servizi di comunicazione. È possibile accedere alle chiavi primarie e secondarie. Ciò può essere utile quando si vuole fornire l'accesso temporaneo alle risorse di Servizi di comunicazione a un ambiente di terze parti o di gestione temporanea.

Screenshot della pagina Chiave di Servizi di comunicazione.

Accedere ai stringa di connessione e agli endpoint di servizio usando l'interfaccia della riga di comando di Azure

È anche possibile accedere alle informazioni sulla chiave usando l'interfaccia della riga di comando di Azure, ad esempio il gruppo di risorse o le chiavi per una risorsa specifica.

Installare l'interfaccia della riga di comando di Azure e usare il comando seguente per accedere. È necessario fornire le credenziali per connettersi con l'account Azure.

az login

È ora possibile accedere a informazioni importanti sulle risorse.

az communication list --resource-group "<resourceGroup>"

az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>"

Se si vuole selezionare una sottoscrizione specifica, è anche possibile specificare il --subscription flag e specificare l'ID sottoscrizione.

az communication list --resource-group  "<resourceGroup>"  --subscription "<subscriptionId>"

az communication list-key --name "<acsResourceName>" --resource-group "<resourceGroup>" --subscription "<subscriptionId>"

Archiviare la stringa di connessione

Gli SDK di Servizi di comunicazione usano stringa di connessione per autorizzare le richieste effettuate a Servizi di comunicazione. Sono disponibili diverse opzioni per l'archiviazione della stringa di connessione:

  • Un'applicazione in esecuzione sul desktop o in un dispositivo può archiviare la stringa di connessione in un file app.config o in un file web.config. Aggiungere la stringa di connessione alla sezione AppSettings in tali file.
  • Un'applicazione in esecuzione in un'istanza di Servizio app di Azure può archiviare la stringa di connessione nelle impostazioni dell'applicazione di Servizio app. Aggiungere la stringa di connessione alla sezione Stringhe di connessione della scheda Impostazioni applicazione nel portale.
  • È possibile archiviare la stringa di connessione in Azure Key Vault.
  • Se l'applicazione viene eseguita localmente, potrebbe essere opportuno archiviare la stringa di connessione in una variabile di ambiente.

Archiviare la stringa di connessione in una variabile di ambiente

Per configurare una variabile di ambiente, aprire una finestra della console e selezionare il sistema operativo dalle schede seguenti. Sostituire <yourconnectionstring> con la stringa di connessione effettiva.

Aprire una finestra della console e immettere il comando seguente:

setx COMMUNICATION_SERVICES_CONNECTION_STRING "<yourConnectionString>"

Dopo aver aggiunto la variabile di ambiente, potrebbe essere necessario riavviare tutti i programmi in esecuzione che leggono la variabile di ambiente, inclusa la finestra della console. Se ad esempio si usa Visual Studio come editor, riavviare Visual Studio prima di eseguire l'esempio.

Pulire le risorse

Se si vuole pulire e rimuovere una sottoscrizione a Servizi di comunicazione, è possibile eliminare la risorsa o il gruppo di risorse. È possibile eliminare la risorsa di comunicazione eseguendo il comando seguente.

az communication delete --name "acsResourceName" --resource-group "resourceGroup"

L'eliminazione del gruppo di risorse elimina anche tutte le altre risorse associate.

Se si dispone di numeri di telefono assegnati alla risorsa al momento dell'eliminazione della risorsa, i numeri di telefono vengono rilasciati automaticamente dalla risorsa contemporaneamente.

Nota

L'eliminazione delle risorse è permanente e non è possibile recuperare dati, inclusi filtri griglia di eventi, numeri di telefono o altri dati associati alla risorsa, se si elimina la risorsa.

Passaggi successivi

In questo argomento di avvio rapido si è appreso come:

  • Creare una risorsa di Servizi di comunicazione
  • Configurare l'area geografica della risorsa e i tag
  • Accedere alle chiavi per la risorsa
  • Eliminare la risorsa

Creare i primi token di accesso utente