---
title: "Gerar endereço para autenticação"
method: POST
path: "/psc/link"
tags: ["API"]
---

# Gerar endereço para autenticação

`POST /psc/link`

Gera um novo endereço para autenticação com o PSC escolhido. O link retornado deve ser exibido ao usuário que irá realizar a autenticação. Após autenticação e seleção do certificado pelo usuário, ele será redirecionado para o endereço enviado em 'redirectUri'. A este endereço também será adicionado o valore 'state' como query parameters. State corresponde ao estado enviado nesta requisição, sem alteração.

## Request body

- object
  - `pscName` string — Nome do PSC para o qual será gerado o link de autenticação
  - `redirectUri` string — Endereço para o qual o usuário será redirecionado após autenticação no PSC. Ao realizar o redirecionamento, serão adicionados os valores 'state' como query parameters.
  - `state` string — Estado para armazenar identificação do usuário. Ele será retornado sem alteração como um 'query parameter' após autenticação.
  - `numberOfDocuments` number — Número de assinaturas que serão realizadas.
  - `scope` 'single_signature' | 'multi_signature' | 'signature_session' — Preferência do escopo de assinatura que será utilizado pela requisição. `single_signature`: será permitido somente uma única assinatura, em uma única requisição. `multi_signature`: será permitido um lote de assinaturas, em uma única requisição. `signature_session`: será permitido uma sessão de assinaturas, permitindo realizar requisições de assinaturas por um determinado período.
  - `lifetime` number — Tempo de duração do token em segundos que será solicitado ao PSC. O tempo de duração do token pode ser modificado pelo PSC.
  - `cpf` string — CPF para filtro do certificado escolhido. Não pode ser utilizado em conjunto com 'cnpj'.
  - `cnpj` string — CNPJ para filtro do certificado escolhido. Não pode ser utilizado em conjunto com 'cpf'.

## Response `200`

Link para autenticação com o PSC selecionado

- object
  - `token` string — Credencial gerada que deverá ser utilizada para os pedidos de assinatura utilizando o HUB Signer após autenticação e escolha do certificado
  - `url` string — Url para autenticação e seleção do certificado PSC

## Other responses

- `400` — Retorno de erro da aplicação
- `500` — Retorno de erro da aplicação

---

[API](https://skmtc.net/bry/apis/bry-easy-sign-api-rest.md) · [All operations](https://skmtc.net/bry/apis/bry-easy-sign-api-rest/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bry/bry-easy-sign-api-rest/revisions/c87e026e87ac/schema)