ANNOUNCEMENT: Voyage AI joins MongoDB to power more accurate and trustworthy AI applications on Atlas.
Learn more
Menu Docs

Autenticação de Database Tools

Nesta página

A partir do 100.11.0, você pode usar ferramentas de banco de dados com o Atlas Workload Identity Federation para autenticar conexões com o MongoDB em execução no Microsoft Azure e no Google Cloud Platform.

Esta seção mostra exemplos de ferramentas de banco de dados que usam o Workload Identity Federation.

Na string de conexão, defina authMechanism como MONGODB-OIDC e defina authMechanismProperties conforme necessário:

  • Para o Microsoft Azure, defina authMechanismProperties como ENVIRONMENT:azure,TOKEN_RESOURCE:<audience>. Observação: omita TOKEN_RESOURCE se estiver usando o Microsoft Azure Kubernetes Service (AKS).

  • Para Google Cloud Platform, defina authMechanismProperties como ENVIRONMENT:gcp,TOKEN_RESOURCE:<audience>.

Substitua <audience> pelo aplicação ou serviço para o qual o token de acesso é destinado. Para obter mais detalhes, consulte Campos do fornecedor de identidade.

O exemplo mongodump a seguir se conecta ao MongoDB usando o Microsoft Azure Instance Metadata Service (IMDS):

mongodump --uri "mongodb://mongodb.example.com:20017/?authMechanism=MONGODB-OIDC&authMechanismProperties=ENVIRONMENT:azure,TOKEN_RESOURCE:https://www.example.com" \
--username admin

Para se conectar ao MongoDB usando o Microsoft Azure Kubernetes Service, defina estas variáveis de ambiente:

Variável de ambiente
Descrição

AZURE_TENANT_ID

Azure tenant identifier.

AZURE_APP_CLIENT_ID

Identificador de cliente do aplicação Azure.

AZURE_CLIENT_ID

Identificador de cliente Azure da identidade gerenciada para autenticar com.

AZURE_FEDERATED_TOKEN_FILE

Caminho do arquivo de token federado do Azure.

Para obter detalhes sobre o Azure e as variáveis, consulte a documentação do Microsoft Azure.

O exemplo mongodump a seguir define as variáveis de ambiente e se conecta ao MongoDB:

AZURE_TENANT_ID=08206ab8-16a0-406d-85e4-2f15f5620fac \
AZURE_APP_CLIENT_ID=b6c835da-e536-425b-9405-64bc471e245b \
AZURE_CLIENT_ID=f176d4eb-7dcd-4f66-bccf-aaa316ee61fd \
AZURE_FEDERATED_TOKEN_FILE=/var/run/secrets/azure/tokens/azure-identity-token \
mongodump --uri "mongodb://mongodb.example.com:20017/?authMechanism=MONGODB-OIDC&authMechanismProperties=ENVIRONMENT:azure" \
--username "admin"

TOKEN_RESOURCE não é necessário para este exemplo.

O seguinte exemplo do mongodump se conecta ao MongoDB no Google Cloud Platform:

mongodump --uri "mongodb://mongodb.example.com:20017/?authMechanism=MONGODB-OIDC&authMechanismProperties=ENVIRONMENT:gcp,TOKEN_RESOURCE:https://www.example.com" \
--username "admin"

Nenhuma variável de ambiente é necessária para o Google Cloud Platform.

Nesta página