Skip to content

Autenticação externa ​

A autenticação externa permite que serviços externos ofereçam recursos de "entrada com Sonolus".

Iniciação ​

Para iniciar a autenticação externa, use um link profundo sonolus://external-login/example.com/path/to/endpoint?foo=bar#hash .

Se o usuário confirmar, uma solicitação POST será enviada ao endpoint.

Cabeçalhos de solicitação ​

CabeçalhoValorDescrição
Sonolus-SignaturestringVeja Sonolus-Signature .

Corpo da solicitação ​

ts
type ServerAuthenticateExternalRequest = {
    type: 'authenticateExternal'
    url: string
    time: number
    userProfile: UserProfile
}

O servidor deve verificar se o corpo da solicitação é autêntico usando o cabeçalho de solicitação Sonolus-Signature .

type ​

O servidor deve verificar se o type é igual a 'authenticateExternal' .

url ​

O servidor deve verificar se url corresponde ao ponto de extremidade de autenticação externa.

time ​

O servidor deve verificar se time é recente.

Código de resposta ​

CódigoDescrição
200 OK
401 UnauthorizedAutenticação rejeitada.

Cabeçalhos de resposta ​

Nenhum.

Corpo de Resposta ​

Corpo de Resposta ​

ts
type ServiceAuthenticateExternalResponse = ServerMessage

Exemplos ​

json
{
    "message": "..."
}