Protocolo de fio

Credenciais

Todas as operações que você emite pelo protocolo de fio são executadas no contexto de um usuário de aplicativo específico que você especifica na connection string. O usuário deve ser registrado com um dos seguintes fornecedores de autenticação:

• E-mail/senha

• Chave API

• JWT personalizado

O conteúdo das credenciais da connection string depende do provedor de autenticação com o qual o usuário se registrou:

Região

A connection string deve especificar a região de implantação e o fornecedor de nuvem no qual o aplicativo está hospedado.

Aplicativos globais usam a região global :

mongodb://<credentials>@global.services.cloud.mongodb.com:27020/?<parameters>

Os aplicativos locais especificam o provedor de nuvem e o nome da região usando o formato <region>.<cloud> . Por exemplo, um aplicativo implantado no aws-us-east-1 utilizaria a seguinte cadeia de conexão:

mongodb://<credentials>@us-east-1.aws.services.cloud.mongodb.com:27020/?<parameters>

Parâmetros

O App Services requer opções específicas de connection string que identificam o aplicativo ao qual você deseja se conectar e o fornecedor de autenticação associado às credenciais fornecidas.

As connection strings do App Services têm os seguintes parâmetros de query:

<app id>:<service>:<provider>

Conecte-se ao App Services com uma connection string

Para se conectar ao App Services através do protocolo de fio, passe um URL codificado App Services connection string ao criar um cliente, da mesma forma que faria com uma connection string comum.

Ler e modificar dados

Enquanto estiver conectado ao App Services através do protocolo de fio, você pode usar operações CRUD padrão do MongoDB. O App Services aplica regras de acesso a dados baseadas em função a todas as queries no contexto do usuário autenticado especificado nas credenciais da connection string.

Chamar uma função

Você pode chamar funções usando o comando callFunction banco de dados.

{
  callFunction: <function name>,
  arguments: [<arg1>, <arg2>, ...]
}

Chame uma ação de serviço [OUSOS]

Você pode chamar ações de serviço usando o comando de banco de dados callServiceFunction .

{
  callServiceFunction: <function name>,
  service: <service name>,
  arguments: [<arg1>, <arg2>, ...]
}

Obtenha os dados do usuário conectado

Você pode obter o objeto de usuário para o usuário autenticado usando o comando userProfile do banco de dados.

{
  userProfile: 1
}