> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Autoriser

> Lancez le flux de code d’autorisation avec PKCE, le type d’octroi OAuth 2.0 recommandé pour les applications mobiles et les applications monopages.

export const ResponseSchema = ({statusCode, type = "{}", children}) => {
  const [open, setOpen] = useState(false);
  return <div className="border border-gray-100 dark:border-gray-800 rounded-lg mb-3 overflow-hidden">
      <div className={`flex items-center gap-2.5 px-4 py-2.5 cursor-pointer select-none ${open ? "bg-gray-50 dark:bg-gray-800" : ""}`} onClick={() => setOpen(!open)}>
        {statusCode && <span className="border border-gray-300 dark:border-gray-600 text-gray-700 dark:text-gray-300 font-mono text-xs px-1.5 py-0.5 rounded">
            {statusCode.startsWith("default") ? "default" : statusCode}
          </span>}
        <span className="text-gray-500 dark:text-gray-400 text-sm font-mono">
          {type}
        </span>
        <span className="text-gray-400 dark:text-gray-500 text-sm italic">
          application/json
        </span>
        <svg className={`ml-auto opacity-50 transition-transform duration-200 ${open ? "rotate-180" : ""}`} width="16" height="16" viewBox="0 0 16 16" fill="none">
          <path d="M4 6l4 4 4-4" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
        </svg>
      </div>
      {open && <div className="px-4 pt-1 pb-3 border-t border-gray-100 dark:border-gray-800">
          {children}
        </div>}
    </div>;
};

<div id="endpoint">
  ## Point de terminaison
</div>

`GET /authorize`

Il s’agit du type d’octroi OAuth 2.0 que les applications mobiles utilisent pour accéder à une API. Avant de commencer ce flux, vous devez générer et stocker un `code_verifier`, puis générer à partir de celui-ci un `code_challenge` qui sera envoyé dans la requête d’autorisation.

<div id="query-parameters">
  ## Paramètres de requête
</div>

<ParamField query="audience" type="string" required>
  L’identifiant unique de l’API cible à laquelle vous souhaitez accéder.
</ParamField>

<ParamField query="resource" type="string">
  L’identifiant de l’API cible (serveur de ressources) à laquelle vous souhaitez accéder. Il doit correspondre à un identifiant d’API enregistré dans votre tenant Auth0. Il est utilisé comme alternative à `audience` lorsque le [profil de compatibilité du paramètre de ressource](https://auth0.com/docs/get-started/tenant-settings#settings-advanced) du tenant est défini sur `compatibility`.
</ParamField>

<ParamField query="scope" type="string">
  Les scopes pour lesquels vous souhaitez demander une autorisation. Ils doivent être séparés par un espace. Vous pouvez demander des scopes OpenID Connect (OIDC) standard, des custom claims ou tout scope pris en charge par l’API cible. Incluez 'offline\_access' pour obtenir un Refresh Token.
</ParamField>

<ParamField query="response_type" type="string" required>
  Indique à Auth0 quel flux OAuth 2.0 vous souhaitez exécuter. Utilisez 'code' pour le flux Authorization Code Grant (PKCE).

  Valeurs autorisées : `code`
</ParamField>

<ParamField query="client_id" type="string" required>
  Le Client ID de votre application.
</ParamField>

<ParamField query="state" type="string">
  Une valeur opaque que le client ajoute à la requête initiale et qu’Auth0 inclut lors de la redirection vers le client. Cette valeur doit être utilisée par le client pour prévenir les attaques CSRF.
</ParamField>

<ParamField query="redirect_uri" type="string">
  L’URL vers laquelle Auth0 redirigera le navigateur une fois que l’autorisation aura été accordée par l’utilisateur.
</ParamField>

<ParamField query="code_challenge_method" type="string" required>
  Méthode utilisée pour générer le challenge. Utilisez `S256`, car Auth0 ne prend en charge que cette méthode.

  Valeurs autorisées : `S256`
</ParamField>

<ParamField query="code_challenge" type="string" required>
  Challenge généré à partir du `code_verifier`.
</ParamField>

<ParamField query="connection" type="string">
  Le nom de la connexion configurée pour votre application.
</ParamField>

<ParamField query="prompt" type="string">
  Pour lancer une requête d’authentication silencieuse, utilisez `prompt=none`.
</ParamField>

<ParamField query="organization" type="string">
  ID de l’organisation à utiliser lors de l’authentication d’un utilisateur.
</ParamField>

<ParamField query="invitation" type="string">
  ID du ticket d’invitation à l’organisation.
</ParamField>

<ParamField query="dpop_jkt" type="string">
  L’empreinte JWK [RFC7638](https://www.rfc-editor.org/rfc/rfc7638.html) de la clé publique de preuve de possession utilisant la fonction de hachage SHA-256.
</ParamField>

<div id="response-schema">
  ## Schéma de réponse
</div>

<ResponseSchema statusCode="erreur par défaut">
  <ResponseField name="error" type="string">
    Code d’erreur.
  </ResponseField>

  <ResponseField name="error_description" type="string">
    Description de l’erreur.
  </ResponseField>
</ResponseSchema>

<div id="response-messages">
  ## Messages de réponse
</div>

| Statut  | Description                                                      |
| ------- | ---------------------------------------------------------------- |
| 302     | Redirection vers le `redirect_uri` indiqué après l’autorisation. |
| default | Erreur inattendue                                                |