Proteja seus dados

Aplicativo de amostra

Você pode usar o seguinte aplicativo de exemplo para testar os exemplos de código nesta página. Para usar o aplicativo de amostra, execute as seguintes etapas:

1. Verifique se a biblioteca PHP do MongoDB está instalada em seu projeto. Para saber mais sobre como instalar a biblioteca PHP do MongoDB , consulte o guia de download e instalação .

2. Copie o seguinte código e cole-o em um novo arquivo .php .

3. Copie um exemplo de código desta página e cole-o nas linhas especificadas no arquivo.

1<?php2
3require __DIR__ . '/vendor/autoload.php';4
5// Start example code here6
7// End example code here8
9try {10    $client->test->command(['ping' => 1]);11    echo 'Successfully pinged the MongoDB server.', PHP_EOL;12} catch (MongoDB\Driver\Exception\RuntimeException $e) {13    printf("Failed to ping the MongoDB server: %s\n", $e->getMessage());14}

MongoDB\ClientCredentials

O código a seguir mostra como passar as credenciais do Amazon Web Services para o construtor MongoDB\Client para autenticação com MONGODB-AWS:

$uriOptions = [    'username' => '<AWS IAM access key ID>',    'password' => '<AWS IAM secret access key>',    'authMechanism' => 'MONGODB-AWS',];
$client = new MongoDB\Client(    'mongodb://<hostname>:<port>',    $uriOptions,);

$uri = 'mongodb://<AWS IAM access key ID>:<AWS IAM secret access key>@<hostname>:<port>/?authMechanism=MONGODB-AWS';$client = new MongoDB\Client($uri);

Para saber mais sobre como autenticar com Amazon Web Services recuperando credenciais MongoDB\Client, consulte MongoDB\Client Credentials no guia Autenticação.

Credenciais externas

O código abaixo mostra como autenticar com MONGODB-AWS ao obter credenciais de variáveis de ambiente, uma solicitação AssumeRoleWithWebIdentity , metadados do ECS ou metadados de instância do EC2 :

$client = new MongoDB\Client(    'mongodb://<hostname>:<port>',    ['authMechanism' => 'MONGODB-AWS'],);

$uri = 'mongodb://<hostname>:<port>/?authMechanism=MONGODB-AWS';$client = new MongoDB\Client($uri);

Para saber mais sobre como autenticar com Amazon Web Services obtendo credenciais externas, consulte as seguintes seções no guia de Autenticação:

• Variáveis de ambiente

• Solicitação AssumeRoleWithWebIdentity

• ECS Metadata

• EC2 Metadados de instância

Habilitar TLS

O código a seguir mostra como habilitar o TLS para a conexão com sua instância do MongoDB :

$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true],);

$uri = 'mongodb://<hostname>:<port>/?tls=true';$client = new MongoDB\Client($uri);

Para saber mais sobre como habilitar o TLS, consulte Habilitar TLS no guia Configuração do TLS.

Especifique um arquivo de autoridade de certificação (CA)

O código a seguir mostra como especificar o caminho do arquivo CA para a conexão com a instância do MongoDB :

$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true, 'tlsCAFile' => '/path/to/ca.pem'],);

$uri = 'mongodb://<hostname>:<port>/?tls=true&tlsCAFile=/path/to/ca.pem';$client = new MongoDB\Client($uri);

Para saber mais sobre como especificar um arquivo CA, consulte Especificar um arquivo CA no guia de configuração TLS.

Desativar verificações OCSP

O seguinte código mostra como impedir que o driver entre em contato com o endpoint OCSP:

$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true, 'tlsDisableOCSPEndpointCheck' => true],);

$uri = 'mongodb://<hostname>:<port>/?tls=true&tlsDisableOCSPEndpointCheck=true';$client = new MongoDB\Client($uri);

Para saber mais sobre como desativar as verificações OCSP, consulte OCSP no guia de configuração do TLS.

Especifique uma lista de revogação de certificados (CRL)

O seguinte código mostra como instruir o driver a verificar o certificado do servidor em relação a uma CRL:

$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true],    ['crl_file' => '/path/to/file.pem'],);

Para saber mais sobre como especificar uma CRL, consulte Lista de revogação de certificados no guia de configuração do TLS.

Apresentar um Certificado de Cliente

O seguinte código mostra como especificar o certificado do cliente que o driver apresenta para sua implantação MongoDB :

$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true, 'tlsCertificateKeyFile' => '/path/to/client.pem'],);

$uri = 'mongodb://<hostname>:<port>/?tls=true&tlsCertificateKeyFile=/path/to/client.pem';$client = new MongoDB\Client($uri);

Para saber mais sobre como especificar um certificado de cliente , consulte Apresentar um certificado de cliente no guia de configuração do TLS.

Forneça uma senha para o arquivo de chave de certificado

O seguinte código mostra como especificar a senha do seu certificado de cliente :

$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    [        'tls' => true,        'tlsCertificateKeyFile' => '/path/to/client.pem',        'tlsCertificateKeyFilePassword' => '<password>',    ],);

$uri = 'mongodb://<hostname>:<port>/?tls=true&tlsCertificateKeyFile=/path/to/client.pem&tlsCertificateKeyFilePassword=<password>';$client = new MongoDB\Client($uri);

Para saber mais sobre como fornecer uma senha de arquivo de chave, consulte Fornecer uma senha de chave no guia Configuração TLS.

Permitir TLS Inseguro

O código a seguir mostra como relaxar as restrições de TLS, que tem o mesmo efeito que desabilitar a validação do certificado e a verificação do nome do host:

// Warning: Use the tlsInsecure option only for testing. Don't use it in production.$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true, 'tlsInsecure' => true],);

// Warning: Use the tlsInsecure option only for testing. Don't use it in production.$uri = 'mongodb://<hostname>:<port>/?tls=true&tlsInsecure=true';$client = new MongoDB\Client($uri);

Para saber mais sobre como permitir TLS inseguro, consulte Permitir TLS Inseguro no guia Configuração de TLS.

Desativar validação do certificado

O seguinte código mostra como desabilitar a validação do certificado:

// Warning: Use the tlsAllowInvalidCertificates option only for testing. Don't use it in production.$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true, 'tlsAllowInvalidCertificates' => true],);

// Warning: Use the tlsAllowInvalidCertificates option only for testing. Don't use it in production.$uri = 'mongodb://<hostname>:<port>/?tls=true&tlsAllowInvalidCertificates=true';$client = new MongoDB\Client($uri);

Para saber mais sobre como desativar a validação do certificado, consulte Permitir TLS inseguro no guia Configuração de TLS.

Desativar verificação de nome de host

O seguinte código mostra como desabilitar a verificação de nome de host:

// Warning: Use the tlsAllowInvalidHostnames option only for testing. Don't use it in production.$client = new MongoDB\Client(    'mongodb://<hostname>:<port>/',    ['tls' => true, 'tlsAllowInvalidHostnames' => true],);

// Warning: Use the tlsAllowInvalidHostnames option only for testing. Don't use it in production.$uri = 'mongodb://<hostname>:<port>/?tls=true&tlsAllowInvalidHostnames=true';$client = new MongoDB\Client($uri);

Para saber mais sobre como desativar a verificação de nome de host, consulte Permitir TLS inseguro no guia Configuração de TLS.