> For the complete documentation index, see [llms.txt](https://docs.radiusaas.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.radiusaas.com/fr/portail-dadministration/acces-et-regles/permissions.md).

# Autorisations

Les autorisations et les jetons d'accès à l'API REST RADIUSaaS peuvent être gérés à l'adresse https\://YOURNAME.radius-as-a-service.com/settings/permissions

## Vue d’ensemble

Le **Autorisations** le menu vous permet de contrôler l’accès au portail d’administration RADIUSaaS et à l’API REST RADIUSaaS.

{% hint style="success" %}
RADIUSaaS prend en charge plusieurs IDP pour l’authentification lors de la connexion au portail d’administration RADIUSaaS.

RADIUSaaS ne stocke ni ne gère ses propres identités d’administrateur.

Par conséquent, les administrateurs bénéficient du confort d’utiliser leurs propres identités et n’ont pas besoin de configurer des comptes supplémentaires.
{% endhint %}

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fyyw9ix1TtbjLHiRzREUf%2Fimage.png?alt=media&amp;token=ed499809-b107-4c56-af40-a1505aecf01c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Les modifications apportées aux attributions de rôles et l’invalidation des jetons utilisateur ne prennent effet qu’après avoir cliqué sur **Enregistrer**.
{% endhint %}

## IDP pris en charge

Sous **Fournisseurs d’authentification autorisés** n’importe lequel (y compris plusieurs) des IDP pris en charge par RADIUSaaS peut être activé :

* Apple (Apple ID)&#x20;
* DigitalOcean (adresse e-mail de l’utilisateur)
* Entra ID (nom principal de l’utilisateur)
* Google (adresse e-mail principale)

En outre, sous **Fournisseur OICD personnalisé** vous pouvez configurer vos propres fournisseurs OpenID Connect pour exploiter d’autres IDP, par exemple Okta ou des clouds Azure souverains (GCC, GCC High, ...).

## Rôles

### Administrateurs

Les identités ou comptes saisis ici peuvent accéder au portail d’administration RADIUSaaS avec **des autorisations complètes de lecture et d’écriture** sur le service. Ces autorisations incluent :&#x20;

* Voir [les tableaux de bord et les journaux](/fr/portail-dadministration/insights.md)
* Voir, ajouter, modifier, supprimer [Utilisateurs](/fr/portail-dadministration/utilisateurs/users.md)
* Voir, ajouter, modifier, supprimer [certificats du serveur RADIUS](/fr/portail-dadministration/settings/settings-server.md#server-certificates) et [certificats approuvés](/fr/portail-dadministration/settings/trusted-roots.md) pour l’authentification client et RadSec
* Voir, ajouter, supprimer [Proxys](/fr/portail-dadministration/settings/settings-proxy.md)
* Voir et modifier les paramètres des autres, y compris les autorisations
* Gérer [Jeton d’accès à l’API REST RADIUSaaS](#access-tokens)
* Accès à tous les [points de terminaison de l’API](/fr/autre/rest-api.md) et opérations CRUD

### Lecteurs

Les identités ou comptes saisis ici peuvent accéder au portail d’administration RADIUSaaS avec **autorisations complètes de lecture** sur le service. Ces autorisations incluent :&#x20;

* Voir [les tableaux de bord et les journaux](/fr/portail-dadministration/insights.md)
* Voir [Utilisateurs](/fr/portail-dadministration/utilisateurs/users.md)
* Voir, ajouter, modifier, supprimer [certificats du serveur RADIUS](/fr/portail-dadministration/settings/settings-server.md#server-certificates) et [certificats approuvés](/fr/portail-dadministration/settings/trusted-roots.md) pour l’authentification client et RadSec
* Voir [Proxys](/fr/portail-dadministration/settings/settings-proxy.md)
* Voir les paramètres des autres (l’autorisation ne peut pas être consultée)
* Accès à tous les [points de terminaison de l’API](/fr/autre/rest-api.md) - **limité aux opérations de lecture**

### Utilisateurs

Les identités ou comptes saisis ici **ne peuvent pas** accéder au portail d’administration RADIUSaaS, cependant, ils peuvent accéder au [**Mes utilisateurs invités**](/fr/portail-dadministration/mes-utilisateurs-invites.md) portail, où ils peuvent créer [Utilisateurs](/fr/portail-dadministration/utilisateurs/users.md) pour l’accès BYOD ou invité.

### Invalider les jetons utilisateur

Lors de l’authentification au portail d’administration RADIUSaaS, chaque identité autorisée obtient un jeton d’accès (bearer) mis en cache dans le stockage des cookies du navigateur. La durée de vie du jeton est de 30 jours. De plus, RADIUSaaS a l’autorisation d’actualiser ces jetons d’accès.

En cas d’incident de sécurité, les administrateurs RADIUSaaS peuvent **invalider tous les jetons d’accès émis précédemment** en définissant la date minimale d’émission à maintenant.&#x20;

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FLnaGdTdP85UpsJz6nWcd%2Fimage.png?alt=media&amp;token=461f28cd-d067-489b-ac57-568ef308e569" alt="" width="563"><figcaption></figcaption></figure>

## Contacts techniques

{% hint style="info" %}
Veuillez noter que cette fonctionnalité est en préparation d’une fonctionnalité de notification dans une future version de RADIUSaaS.
{% endhint %}

Ajoutez jusqu’à 5 contacts techniques pour recevoir des notifications par e-mail liées à votre instance. Vous pouvez sélectionner le niveau d’événement pour chaque contact.

<table><thead><tr><th width="137">Niveau d’événement</th><th>Exemples d’événements</th></tr></thead><tbody><tr><td>Info</td><td>Mises à jour planifiées de votre instance.</td></tr><tr><td>Avertissement</td><td>Un certificat est sur le point d’expirer, ou un FAI rencontre des problèmes susceptibles d’avoir un impact sur votre instance.</td></tr><tr><td>Critique</td><td>Interruption de votre instance. </td></tr></tbody></table>

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FGucXrO98ppH2IGFCADSM%2F2024-12-06_11h41_45.png?alt=media&amp;token=5b78dbc4-d079-40f0-9134-a8ad7dda37a6" alt=""><figcaption></figcaption></figure>

## Jetons d’accès

Les jetons d’accès sont nécessaires pour authentifier les appels à l’ [API REST RADIUSaaS](/fr/autre/rest-api.md).

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2F3XPgqLQgguUYdUeC3fAB%2Fimage.png?alt=media&amp;token=b365d3dd-38e0-4878-9ee2-eea8e0d8753d" alt=""><figcaption></figcaption></figure>

### Ajouter

Suivez ces étapes pour créer un nouveau jeton d’accès :

1. Cliquez sur **Ajouter**
2. Indiquez un **Nom** pertinent pour le jeton d’accès
3. Définissez le niveau d’autorisation en sélectionnant un [**rôle**](#roles)
4. Sélectionnez la durée de vie du jeton d’accès
5. Cliquez sur **Créer**\
   ![](https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fs4fakstavtZVWVgMVH1K%2Fimage.png?alt=media\&token=5877ff38-7f1c-474a-bdf9-aeab763b49c7)<br>
6. Copiez le jeton d’accès dans le presse-papiers et stockez-le dans un emplacement sécurisé.\
   ![](https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2F42kTjdesW5amEcScFa7C%2FScreenshot_2024-05-23_at_18_46_08.jpg?alt=media\&token=d7c71247-eccb-47f1-821f-0ccb1bde55ec)
7. Cliquez sur **Fermer**

### **Supprimer**

Pour supprimer un jeton d’accès, repérez-le dans le tableau et cliquez sur l’icône de corbeille :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fly5SYNorElOwmEF0O4Bs%2FScreenshot%202026-02-25%20at%2017.33.02.png?alt=media&amp;token=d6fef168-ecb3-4db0-9de0-e1fe7de4330a" alt=""><figcaption></figcaption></figure>

## Consentement des autorisations

Choisissez parmi différents fournisseurs d’identité pour pouvoir vous connecter à votre portail.

{% tabs %}
{% tab title="Entra ID" %}

Les comptes Microsoft Entra ID (Azure AD) qui se connectent pour la première fois au portail d’administration RADIUSaaS doivent accorder à RADIUSaaS un ensemble limité de [autorisations dans leur Tenant Azure](https://docs.radiusaas.com/fr/portail-dadministration/acces-et-regles/pages/12ec49b564e9aa1e02b4b597afa11bd644925325#id-5.-which-tenant-permissions-do-users-accessing-the-radiusaas-web-portal-have-to-consent-to).

Il existe deux façons alternatives de fournir le consentement :

* **Consentement de l’utilisateur**\
  Chaque utilisateur accepte le consentement lors de sa première connexion au portail.
* **Consentement administrateur**\
  Un administrateur peut donner son consentement au nom de l’organisation pour tous les utilisateurs.

### Consentement de l’utilisateur

Si aucun consentement n’a été donné auparavant au nom de l’organisation par un administrateur, un utilisateur verra une boîte de dialogue de demande d’autorisations :

<figure><img src="https://content.gitbook.com/content/SWU1DQ4UGkqER7uGNUOm/blobs/Whj6dRSGUJFm7zJUfVjv/image.png" alt=""><figcaption></figcaption></figure>

Les utilisateurs peuvent consulter ou révoquer ce consentement dans Microsoft [My Apps](< https://myapps.microsoft.com>).

<figure><img src="https://content.gitbook.com/content/SWU1DQ4UGkqER7uGNUOm/blobs/xjm5mD9gdtNJOZWoQ4Zi/image.png" alt=""><figcaption></figcaption></figure>

Les administrateurs peuvent consulter et révoquer les consentements des utilisateurs dans Azure Portal (**Microsoft Entra ID** > **Applications d’entreprise** > **RADIUS as a Service**):

<figure><img src="https://content.gitbook.com/content/SWU1DQ4UGkqER7uGNUOm/blobs/Hf30pa88xZZZySTcc7gL/image.png" alt=""><figcaption></figcaption></figure>

### Consentement administrateur

Plutôt que d’exiger le consentement de chaque utilisateur, les administrateurs peuvent accorder le consentement pour tous les utilisateurs au nom de l’organisation lors de la première connexion au portail web RADIUSaaS :

<figure><img src="https://content.gitbook.com/content/SWU1DQ4UGkqER7uGNUOm/blobs/EB1IjdY0ixwIpOm9Ys5C/image.png" alt=""><figcaption></figcaption></figure>

Sinon, les administrateurs peuvent accorder le consentement au nom de l’organisation dans le portail Azure (**Microsoft Entra ID** > **Applications d’entreprise** > **RADIUS as a Service**). Dans Azure Portal, les administrateurs peuvent également consulter ou révoquer le consentement :

<figure><img src="https://content.gitbook.com/content/SWU1DQ4UGkqER7uGNUOm/blobs/JnCFDpixcJXfZzdCyHx4/image.png" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Apple" %}
Lors de l’utilisation d’un Apple ID pour vous connecter à RADIUSaaS, assurez-vous de **ne pas masquer** votre adresse e-mail.

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fe5EuZ59EC1vsOpHA9R0P%2Fimage.png?alt=media&amp;token=6ef2dbf5-4453-4a09-96c3-1148509c9e67" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Si vous choisissez de masquer votre e-mail dans cette boîte de dialogue, vous ne pourrez pas vous connecter à votre portail. Vous devrez alors supprimer l’application RADIUSaaS sur **account.apple.com** dans la **Se connecter avec Apple** section
{% endhint %}
{% endtab %}

{% tab title="Digital Ocean" %}
Digital Ocean vous demandera d’autoriser l’application sur une équipe afin de pouvoir vous connecter :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FxZYfitlR8gTW4MczGSYc%2Fimage.png?alt=media&amp;token=5e9da2a3-5b29-4127-af3c-e1712c858e5e" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Google" %}
Google vous demandera d’autoriser l’application à accéder à des données limitées sur votre compte.

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FTAvDqZsSxfp4cm1JXBtD%2Fimage.png?alt=media&amp;token=03af565c-e409-41c8-bb34-47bb4eeb6827" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Fournisseur OIDC personnalisé (Okta)" %}
Les informations spécifiques à fournir pour le fournisseur OIDC personnalisé dépendent du fournisseur d’identité que vous choisissez. L’exemple suivant **exemple** est basé sur **Okta**.

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FuEXUhGcJaXbhYXw7S8Fu%2Fimage.png?alt=media&amp;token=e98d23b2-7ecc-47c0-8fb3-bf45211ec70d" alt=""><figcaption></figcaption></figure>

Dans la console d’administration Okta, vous devrez créer une nouvelle intégration d’application avec les détails suivants :

| Méthode de connexion            | OIDC - OpenID Connect                                                                                                          |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Type d’application              | Application Web                                                                                                                |
| URI de redirection de connexion | Fourni dans la boîte de dialogue RADIUSaaS ci-dessus\nExemple : <https://eu1.radius-as-a-service.com/loginserver/authResponse> |

Assurez-vous d’attribuer l’intégration au groupe d’utilisateurs prévu et d’enregistrer. Vous pouvez maintenant récupérer les informations requises depuis cette application pour les saisir dans RADIUSaaS :

Le **Nom d’affichage** peut être choisi librement et sera affiché lors de la connexion.

Avec Okta, l’ **URL d’authentification** est de la forme suivante :

`https://`**`{YourOrga}`**`.okta.com/oauth2/v1/authorize`

L’URL du jeton est également construite et ressemble à ceci :

`https://`**`{YourOrga}`**`.okta.com/oauth2/v1/token`

Le **ID client** et **Secret client** peut être copié et créé directement dans l’application :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FEVB8IugvO1b3tUQAeatA%2Fimage.png?alt=media&amp;token=8998921b-4b1f-4e47-9db9-233431a838d5" alt=""><figcaption></figcaption></figure>

Pour le **Portée client** `openid email` est requis. Cela indiquera à Okta que nous utilisons une authentification OpenID et que nous devons lire l’adresse e-mail des utilisateurs connectés.

Après avoir enregistré et autorisé ce fournisseur, vous devriez pouvoir l’utiliser pour vous authentifier depuis la page de connexion :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2F0MRlBRVwq5LiFMOAcSht%2Fimage.png?alt=media&amp;token=0d28e700-3ce1-489f-98ab-9784e9e580cf" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Fournisseur OIDC personnalisé (Entra ID)" %}
Si nécessaire dans certains scénarios (p. ex. **GCC High** tenants), vous pouvez également utiliser une inscription d’application Entra ID créée par vos soins pour vous authentifier sur votre portail RADIUSaaS.

#### Préparation

Avant de créer l’inscription d’application, assurez-vous de copier l’URL de redirection depuis la **Autorisations** section de votre portail RADIUSaaS. Vous pouvez trouver l’URL en haut de la **Fournisseur OIDC personnalisé** boîte de dialogue d’édition :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2F4Xd1vQgzqzKWblLPTO35%2Fimage.png?alt=media&amp;token=0cbcadfc-f1eb-4847-8261-2f16a3b1b139" alt="Click on the Edit button to find the redirect URL"><figcaption></figcaption></figure>

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FpAY9jOJYugXmcuM1UDeQ%2Fimage.png?alt=media&amp;token=40bd205c-1cd8-4a0b-9a25-9da4d11259cc" alt="Copy the redirect URL from the dialogues header"><figcaption></figcaption></figure>

### Créer une inscription d’application

Dans Entra ID, accédez à **Inscriptions d’applications** et créez une nouvelle inscription :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fzg2fyhdDN5pISvI1KjUt%2Fimage.png?alt=media&amp;token=a8d2eeb8-5b05-4d34-894e-ba83e36d3cb7" alt=""><figcaption></figcaption></figure>

Sélectionnez un **Nom** descriptif pour l’inscription et ajoutez l’URI de redirection que vous avez copié à l’étape précédente en tant que **Web** type.

#### Ajouter des autorisations d’API

Dans l’inscription créée, accédez à **autorisations d’API** et ajoutez `email` et `openid` depuis Microsoft Graph en tant que **Déléguées** autorisations. Assurez-vous également d’accorder le consentement administrateur pour votre Tenant :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FQq24dkHU03MSR6qI0ajP%2Fimage.png?alt=media&amp;token=ccbb60b2-cdb0-4f83-827a-8b2d867465af" alt=""><figcaption></figcaption></figure>

#### Ajouter un secret client

Pour permettre à RADIUSaaS d’utiliser cette inscription, créez un secret client dans la **Certificats et secrets** section de l’inscription. Copiez la valeur du secret pour plus tard.

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fs7Ujg2gb86TRylYApprk%2Fimage.png?alt=media&amp;token=c9ec97d2-c6a0-48b3-9c68-6727219ba932" alt=""><figcaption></figcaption></figure>

#### Noter les détails de l’inscription

Vous aurez ultérieurement besoin des inscriptions **ID client** et de certaines URL spécifiques à votre Tenant. Vous pouvez les trouver dans la page Vue d’ensemble de l’inscription :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fd1xpptiKjJyhRfnkKyMT%2Fimage.png?alt=media&amp;token=bbd97ab9-378a-433a-aa7c-e4ed4746e757" alt=""><figcaption></figcaption></figure>

#### Attribuer des utilisateurs

Pour que quiconque puisse utiliser cette inscription d’application pour se connecter, assurez-vous de les ajouter dans l’application d’entreprise gérée. Vous pouvez la trouver dans Entra ID dans **Applications d’entreprise** portant le même nom que votre inscription d’application. Un lien vers celle-ci se trouve également dans la vue d’ensemble de l’inscription d’application.

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2Fey2lPelBnCcdzk1a9xkc%2Fimage.png?alt=media&amp;token=ed2a9950-31c3-47b9-8492-c06223a3329a" alt="Assign users to allow them to use the application"><figcaption></figcaption></figure>

### Configurer le fournisseur OIDC dans RADIUSaaS

De retour dans le portail RADIUSaaS, accédez à la section Autorisations et modifiez le fournisseur OIDC personnalisé, puis renseignez les informations requises :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2FSY5LeHQxsb0xkkCecLhb%2Fimage.png?alt=media&amp;token=274f787e-483f-4649-8a0a-0eb0da403ebc" alt=""><figcaption></figcaption></figure>

| Champ                  | Explication                                                                                              |
| ---------------------- | -------------------------------------------------------------------------------------------------------- |
| Nom d’affichage        | Ce nom sera affiché sur la page de connexion                                                             |
| URL d’authentification | `point de terminaison d’autorisation OAuth 2.0 (v2)` à partir des points de terminaison des inscriptions |
| URL du jeton           | `point de terminaison du jeton OAuth 2.0 (v2)` à partir des points de terminaison des inscriptions       |
| ID client              | L’ID client de l’inscription d’application. Peut être trouvé sur sa page Vue d’ensemble                  |
| Secret client          | Le secret client créé précédemment                                                                       |
| Portée client          | Définit les informations demandées pendant l’authentification. Saisissez `openid email` ici.             |

Après avoir enregistré la configuration, assurez-vous d’autoriser le fournisseur personnalisé et d’ajouter quelques utilisateurs pour ce fournisseur. Vous devriez maintenant pouvoir utiliser le fournisseur pour vous connecter à votre portail RADIUSaaS :

<figure><img src="https://1168716614-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSWU1DQ4UGkqER7uGNUOm%2Fuploads%2F83u6Jn9KYrPpnZF2l2j7%2Fimage.png?alt=media&amp;token=6a24c665-472d-4bde-b3a6-7bad0998b868" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Il peut être nécessaire qu’un administrateur Entra utilise d’abord cette connexion pour donner à nouveau son consentement pour son Tenant. Cela ne doit être fait qu’une seule fois.
{% endhint %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.radiusaas.com/fr/portail-dadministration/acces-et-regles/permissions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.