authentication Módulo
Contém funcionalidade para gerenciar diferentes tipos de autenticação no Azure Machine Learning.
Tipos de autenticação suportados:
- Logon interativo - O modo padrão ao usar o SDK do Azure Machine Learning. Usa uma caixa de diálogo interativa.
- CLI do Azure - Para uso com o pacote azure-cli .
- Service Principal - Para uso com fluxos de trabalho automatizados de aprendizado de máquina.
- MSI - Para uso com ativos habilitados para Identidade de Serviço Gerenciado, como com uma Máquina Virtual do Azure.
- Token do Azure ML - Usado para adquirir tokens do Azure ML apenas para execuções enviadas.
Para saber mais sobre esses mecanismos de autenticação, consulte https://aka.ms/aml-notebook-auth.
Classes
| AbstractAuthentication |
Classe pai abstrata para todas as classes de autenticação no Azure Machine Learning. As classes derivadas fornecem diferentes meios para autenticar e adquirir um token com base em seu caso de uso direcionado. Para obter exemplos de autenticação, consulte https://aka.ms/aml-notebook-auth. Classe AbstractAuthentication construtor. |
| AccessToken |
Criar nova instância de AccessToken(token, expires_on) |
| ArmTokenAuthentication |
Usado internamente para adquirir tokens de acesso ARM usando o princípio de serviço ou autenticação de identidade de serviço gerenciado. Para fluxos de trabalho automatizados em que o controle de acesso gerenciado é necessário, use o ServicePrincipalAuthentication botão em vez disso. Classe ArmTokenAuthentification construtor. |
| AzureCliAuthentication |
Gerencia a autenticação e adquire um token de acesso usando a CLI do Azure. Para usar essa classe, você deve ter o pacote azure-cli instalado. Para uma melhor experiência do Azure Notebooks, use a InteractiveLoginAuthentication classe. Construtor Class Azure Cli Authentication. |
| AzureMLTokenAuthentication |
Gerencia tokens de autenticação e acesso no contexto de execuções enviadas. O token do Azure Machine Learning é gerado quando uma execução é enviada e só está disponível para o código que enviou a execução. A classe AzureMLTokenAuthentication só pode ser usada no contexto da execução enviada. O token retornado não pode ser usado em nenhuma operação do Azure Resource Manager (ARM), como o provisionamento de computação. O token do Azure Machine Learning é útil ao executar um programa remotamente onde pode não ser seguro usar as credenciais privadas de um usuário. Autorize usuários por seu token do Azure ML. O token do Azure ML é gerado quando uma execução é enviada e só está disponível para o código enviado. A classe só pode ser usada no contexto da execução enviada. O token não pode ser usado em operações ARM, como provisionamento de computação. O token do Azure ML é útil ao executar um programa remotamente onde pode não ser seguro usar as credenciais privadas do usuário. O consumidor dessa classe deve chamar o método de classe create que cria um novo objeto ou retorna uma instância registrada com a mesma run_scope (subscription_id, resource_group_name, workspace_name, experiment_name run_id) fornecida. |
| InteractiveLoginAuthentication |
Gerencia a autenticação e adquire um token de autorização em fluxos de trabalho de login interativos. A autenticação de logon interativo é adequada para experimentação local em seu próprio computador e é o modelo de autenticação padrão ao usar o SDK do Azure Machine Learning. Por exemplo, ao trabalhar localmente em um bloco de anotações Jupyter, o processo de autenticação de login interativo abre uma janela do navegador para solicitar credenciais se as credenciais ainda não existirem. Construtor Class Interactive Login Authentication. Este construtor solicitará que o usuário faça login e, em seguida, salvará as credenciais para quaisquer tentativas subsequentes. Se o usuário já estiver conectado à CLI do azure ou tiver feito login antes, o construtor carregará as credenciais existentes sem prompt. Quando esse processo python estiver em execução no serviço Bloco de Anotações do Azure, o construtor tentará usar o recurso "conectar ao azure" nos Blocos de Anotações do Azure. Se esse processo python estiver sendo executado em uma VM Notebook, o construtor tentará usar MSI auth. |
| MsiAuthentication |
Gerencia a autenticação usando uma identidade gerenciada no Azure Ative Directory. Ao usar o SDK do Azure ML na Máquina Virtual (VM) do Azure, você pode autenticar com uma identidade gerenciada (anteriormente conhecida como Identidade de Serviço Gerenciado - MSI). O uso de uma identidade gerenciada permite que a VM se conecte ao seu espaço de trabalho sem armazenar credenciais em código Python, desacoplando assim o processo de autenticação de qualquer login de usuário específico. Classe MsiAuthentication construtor. |
| ServicePrincipalAuthentication |
Gerencia a autenticação usando um princípio de serviço em vez de uma identidade de usuário. A autenticação da entidade de serviço é adequada para fluxos de trabalho automatizados, como para cenários de CI/CD. Esse tipo de autenticação separa o processo de autenticação de qualquer login de usuário específico e permite o controle de acesso gerenciado. Classe ServicePrincipalAuthentication construtor. |
| TokenAuthentication |
Gerencie a autenticação usando o token AAD com escopo por público. A autenticação de token é adequada quando a geração de token e sua atualização estão fora do AML SDK. Esse tipo de autenticação permite um maior controle sobre a geração de tokens e sua atualização. Para fluxos de trabalho automatizados em que o controle de acesso gerenciado é necessário, use o ServicePrincipalAuthentication botão em vez disso. Essa classe requer get_token_for_audience método seja fornecido que será chamado para recuperar o token. Exemplo de como get_token_for_audience será chamado e será passado um público get_token_for_audience(audiência) Gerencie a autenticação usando o token AAD com escopo por público. A autenticação de token é adequada quando a geração de token e sua atualização estão fora do AML SDK. Esse tipo de autenticação permite um maior controle sobre a geração de tokens e sua atualização. Para fluxos de trabalho automatizados em que o controle de acesso gerenciado é necessário, use o ServicePrincipalAuthentication botão em vez disso. Essa classe requer get_token_for_audience método seja fornecido que será chamado para recuperar o token. Exemplo de como get_token_for_audience será chamado e será passado um público get_token_for_audience(audiência) onde o público pode ser ARM ou AML auth = TokenAuthentication(get_token_for_audience)
|
Enumerações
| Audience |
Público suportado pela AML. Para ser usado somente com a classe TokenAuthentication . |