Gérer les jetons d’authentification

Génerez et validez vos jetons

Le service token permet de générer un jeton pour des documents donnés ou encore de rallonger la durée de vie d’un jeton.

Génération de jetons

Les exemples ci dessous indiquent comment génerer des jetons utilisateurs.

Générer un jeton avec une durée de vie spécifique

L’exemple ci-dessous indique comment générer un jeton avec une durée de vie paramètrable pour l’utilisateur authentifié.


POST {{core}}/rest/token?validityTime={validityTime} HTTP/1.1

-- Paramètres d'URL --
core: host de FlowerDocs core
validityTime : la validité du token en secondes

-- Headers --
token: {{token}}
Content-Type: application/json


    @Autowired
    private TokenService tokenService;

    public String generateToken(long validityTime) throws FunctionalException, TechnicalException
    {
        return service.generate(validityTime);
    }

Générer un nouveau token

L’exemple ci dessous permet de générer un nouveau token pour l’utilisateur authentifié.


PUT {{core}}/rest/token HTTP/1.1

-- Paramètres d'URL --
core: host de FlowerDocs core

-- Headers --
token: {{token}}
Content-Type: application/json


    @Autowired
    private TokenService tokenService;

    public String generateToken() throws FunctionalException, TechnicalException
    {
        return service.generate();
    }

Générer un token pour accéder à des documents

L’exemple ci dessous permet de générer un nouveau token pour l’utilisateur authentifié afin d’accéder à une liste de documents spécifiques.


POST {{core}}/rest/token/document/{ids}?readOnly={readOnly} HTTP/1.1

-- Paramètres d'URL --
core: host de FlowerDocs core
ids: identifiants des documents pour lesquel générer le token
readOnly : true or false pour accès en lecture seule ou non

-- Headers --
token: {{token}}
Content-Type: application/json


    @Autowired
    private TokenService tokenService;

    public String generateForDocuments(List<id> ids, boolean readOnly) throws FunctionalException, TechnicalException
    {
        return service.generateForDocuments(ids, readOnly);
    }

Validation d’un token

L’ exemple ci dessous permet de valider un token.


POST {{core}}/rest/token/{tokenToValidate} HTTP/1.1

-- Paramètres d'URL --
core: host de FlowerDocs core
tokenToValidate : le token à valider

-- Headers --
token: {{token}}
Content-Type: application/json


    @Autowired
    private TokenService tokenService;

    public String validateToken(String token) throws FunctionalException, TechnicalException
    {
        return service.validate(token);
    }