Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo illustra come gestire le identità in Microsoft Entra ID e come configurare il controllo degli accessi in base al ruolo (RBAC) per Computer Planetario Pro di Microsoft. Questo processo consente all'utente di assegnare autorizzazioni di accesso alle risorse GeoCatalog specifiche alle identità di Microsoft Entra.
Prerequisiti
- Account Azure con una sottoscrizione attiva: creare un account gratuito
- Una risorsa GeoCatalog esistente
- interfaccia della riga di comando di Azure (per l'assegnazione di ruolo basata sull'interfaccia della riga di comando)
- Autenticato su Azure tramite
az login. L'API del piano di controllo di GeoCatalog richiede l'autenticazione OAuth2 di Azure Active Directory con l'ambitouser_impersonation. Il interfaccia della riga di comando di Azure gestisce automaticamente questa operazione dopo l'accesso.
Creazione e gestione di utenti
Creare e gestire l'elenco degli utenti seguendo l'articolo informativo su Microsoft Entra ID su come creare, invitare ed eliminare gli utenti. Dopo aver creato gli utenti, è necessario concedere loro le autorizzazioni appropriate per accedere a una risorsa GeoCatalog, assegnando uno o più ruoli RBAC.
Planetary Computer Pro definisce due ruoli specifici delle risorse GeoCatalog, oltre ai ruoli predefiniti di Azure:
| Ruolo | Descrizione | Consente la gestione del controllo degli accessi in base al ruolo? |
|---|---|---|
| Amministratore GeoCatalog | Consente all'utente di leggere, scrivere ed eliminare dati all'interno di un GeoCatalog | NO |
| Lettore GeoCatalog | Consente all'utente di leggere solo i dati GeoCatalogs. | NO |
| Proprietario | Ruolo predefinito di Azure che concede l'accesso completo a tutte le risorse, inclusa la capacità di gestire il controllo degli accessi in base al ruolo. | Sì |
| Amministratore accessi utente | Ruolo predefinito di Azure che consente la gestione dell'accesso utente alle risorse di Azure. | Sì |
| Amministratore controllo degli accessi in base al ruolo | Ruolo predefinito di Azure che consente la gestione delle assegnazioni di RBAC e dei permessi. | Sì |
Annotazioni
Il proprietario è anche un amministratore GeoCatalog.
Panoramica dell'autenticazione e dell'autorizzazione
Prima che un'identità possa essere autorizzata tramite il controllo degli accessi in base al ruolo, deve prima eseguire l'autenticazione per Microsoft Entra ID. Il metodo di autenticazione dipende dal tipo di identità che accede a GeoCatalog:
| Tipo di identità | Metodo di autenticazione | Autorizzare quindi con |
|---|---|---|
| Utente (portale, interfaccia della riga di comando, Explorer) | Accesso interattivo (az login o tramite browser OAuth2) |
Ruoli RBAC assegnati in questo articolo |
| Identità gestita (app in Azure) | Token automatico tramite infrastruttura Azure | Ruoli RBAC assegnati in questo articolo |
| Entità servizio (app esterne ad Azure) | Segreto client/certificato tramite registrazione dell'app Entra | Ruoli RBAC assegnati in questo articolo |
Tutte le operazioni del piano di controllo GeoCatalog e del piano dati richiedono un token di connessione OAuth2 valido con l'ambito user_impersonation. Per informazioni dettagliate sulla configurazione per ogni scenario, vedere Configurare l'autenticazione dell'applicazione. Per ulteriori informazioni sui ruoli di RBAC di Azure, vedi Panoramica del controllo degli accessi in base al ruolo di Azure.
Assegnare il controllo degli accessi in base al ruolo a un utente
È possibile usare il portale di Azure per assegnare ruoli RBAC agli utenti del Planetary Computer Pro. Questa sezione illustra come usare i controlli IAM (GeoCatalog Controllo di accesso) per assegnare il ruolo di amministratore GeoCatalog a uno o più utenti.
Nel portale di Azure passare alla scheda Controllo di accesso alle risorse GeoCatalog (IAM) nella barra laterale sinistra:
Selezionare Aggiungi assegnazione>di ruolo.
Selezionare GeoCatalog Administrator (Amministratore GeoCatalog ) nell'elenco dei ruoli della funzione job e quindi selezionare il pulsante Avanti nella parte inferiore della pagina:
Selezionare il pulsante di opzione dell’Utente, gruppo o entità servizio:
Selezionare Seleziona membri
Cercare l'utente nel riquadro Seleziona membri visualizzato sul lato destro. Selezionare un nome o un'identità dall'elenco per aggiungerlo all'elenco Membri selezionati. Ripetere questo passaggio per ognuno degli utenti a cui è necessario assegnare questo ruolo.
Quando vengono selezionati tutti gli utenti per i quali è necessario assegnare questo ruolo, usare il pulsante Seleziona nella parte inferiore del riquadro per chiudere il riquadro.
Nella parte inferiore della pagina, selezionare Avanti.
Verificare le informazioni, quindi completare l'assegnazione selezionando rivedi e assegna.
Ora gli utenti selezionati sono in grado di accedere alla risorsa GeoCatalog, tramite il portale di Azure o le API.
Assegnare ruoli usando il interfaccia della riga di comando di Azure
È anche possibile assegnare ruoli RBAC usando l'interfaccia della riga di comando di Azure, che richiama l'API del piano di controllo dell'ARM (Microsoft.Authorization/roleAssignments).
Assegnare un ruolo
# Define variables
SUBSCRIPTION_ID="{your-subscription-id}"
RESOURCE_GROUP="{your-resource-group}"
GEOCATALOG_NAME="{your-geocatalog-name}"
ASSIGNEE_OBJECT_ID="{user-or-service-principal-object-id}"
# GeoCatalog Administrator role definition ID
ROLE_DEFINITION_ID="$(az role definition list --name "GeoCatalog Administrator" --query "[0].id" -o tsv)"
# Assign the role scoped to the GeoCatalog resource
az role assignment create \
--assignee-object-id "$ASSIGNEE_OBJECT_ID" \
--role "$ROLE_DEFINITION_ID" \
--scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Orbital/geoCatalogs/$GEOCATALOG_NAME"
Rimuovere un'assegnazione di ruolo
az role assignment delete \
--assignee "$ASSIGNEE_OBJECT_ID" \
--role "GeoCatalog Administrator" \
--scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Orbital/geoCatalogs/$GEOCATALOG_NAME"
Elencare le assegnazioni di ruolo per un GeoCatalog
az role assignment list \
--scope "/subscriptions/$SUBSCRIPTION_ID/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Orbital/geoCatalogs/$GEOCATALOG_NAME" \
--output table