Compartilhar via


az communication identity token

Note

Essa referência faz parte da extensão de comunicação da CLI do Azure (versão 2.67.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando de token de identidade de comunicação az. Saiba mais sobre extensões.

Esse grupo de comandos foi preterido e será removido em uma versão futura. Em vez disso, use o "token de identidade do usuário de comunicação".

Comandos para gerenciar tokens de usuário para um recurso do Serviço de Comunicação.

Comandos

Nome Description Tipo Status
az communication identity token get-for-teams-user

Troca um token de acesso do Azure AD (Azure Active Directory) de um usuário do Teams por um novo token de acesso de identidade do ACS com um tempo de expiração correspondente.

Extension Deprecated
az communication identity token issue

Emite um novo token de acesso com os escopos especificados para uma determinada Identidade de Usuário. Se nenhuma Identidade de Usuário for especificada, também criará uma nova Identidade de Usuário.

Extension Deprecated
az communication identity token revoke

Revoga todos os tokens de acesso para a identidade acs específica.

Extension Deprecated

az communication identity token get-for-teams-user

Preterido

Esse comando foi substituído implicitamente porque o "token de identidade de comunicação" do grupo de comandos foi preterido e será removido em uma versão futura. Em vez disso, use o "token de identidade do usuário de comunicação".

Troca um token de acesso do Azure AD (Azure Active Directory) de um usuário do Teams por um novo token de acesso de identidade do ACS com um tempo de expiração correspondente.

az communication identity token get-for-teams-user --aad-token
                                                   --aad-user
                                                   --client
                                                   [--connection-string]

Exemplos

Obter token para o usuário do Teams

az communication identity token get-for-teams-user --aad-token "aad-123-xyz" --client "app-id-123-xyz" --aad-user "uid"

Parâmetros Exigidos

--aad-token

Token de acesso do Azure AD de um usuário do Teams.

--aad-user

ID de objeto de um usuário do Azure AD (Usuário do Teams) a ser verificado em relação à declaração OID no token de acesso do Azure AD.

--client

ID do cliente de um aplicativo do Azure AD a ser verificada em relação à declaração appId no token de acesso do Azure AD.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--connection-string

Cadeia de conexão de comunicação. Variável de ambiente: AZURE_COMMUNICATION_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Communication Arguments
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az communication identity token issue

Preterido

Esse comando foi substituído implicitamente porque o "token de identidade de comunicação" do grupo de comandos foi preterido e será removido em uma versão futura. Em vez disso, use o "token de identidade do usuário de comunicação".

Emite um novo token de acesso com os escopos especificados para uma determinada Identidade de Usuário. Se nenhuma Identidade de Usuário for especificada, também criará uma nova Identidade de Usuário.

az communication identity token issue --scope
                                      [--connection-string]
                                      [--user]

Exemplos

Emitir token de acesso

az communication identity token issue --scope chat

Emitir token de acesso com vários escopos e usuário

az communication identity token issue --scope chat voip --user "8:acs:xxxxxx"

Parâmetros Exigidos

--scope

Lista de escopos para um token de acesso ex: chat/voip.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--connection-string

Cadeia de conexão de comunicação. Variável de ambiente: AZURE_COMMUNICATION_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Communication Arguments
--user

Identificador acs.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az communication identity token revoke

Preterido

Esse comando foi substituído implicitamente porque o "token de identidade de comunicação" do grupo de comandos foi preterido e será removido em uma versão futura. Em vez disso, use o "token de identidade do usuário de comunicação".

Revoga todos os tokens de acesso para a identidade acs específica.

az communication identity token revoke --user
                                       [--connection-string]
                                       [--yes]

Exemplos

Revogar tokens de acesso

az communication identity token revoke --user "8:acs:xxxxxx"

Parâmetros Exigidos

--user

Identificador acs.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--connection-string

Cadeia de conexão de comunicação. Variável de ambiente: AZURE_COMMUNICATION_CONNECTION_STRING.

Propriedade Valor
Grupo de parâmetros: Communication Arguments
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False