> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/fr/guide/account/user-applications/creating-new-user-applications.md).

# Création de nouvelles Applications utilisateur

Configurez une nouvelle application utilisateur dans Navixy en paramétrant l’URL d’intégration et d’autres paramètres pour connecter un outil externe à l’interface de la plateforme.

Lorsque vous configurez une nouvelle **Application utilisateur**, vous devrez travailler avec plusieurs configurations clés qui déterminent la manière dont votre application externe s'intègre à la plateforme Navixy. Examinons chaque composant essentiel.

Commencez par cliquer sur la <img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-b205ed1cd11ae77328c30a95f8af7d8d5be21be8%2Fchrome_py0qhiu5p8.webp?alt=media" alt="chrome_py0qhiu5p8.webp" data-size="line"> bouton dans la **Applications utilisateur** liste. Dans le formulaire de configuration qui s'affiche, suivez les étapes suivantes :

{% stepper %}
{% step %}

## Configurer l'URL

Indiquez l'URL de votre application, l'adresse à laquelle votre application est hébergée ; elle sert de base à l'intégration.

{% hint style="danger" %}

* Assurez-vous que l'URL est valide, utilise une connexion HTTPS, mène vers une ressource fiable et contient au plus 1 000 caractères.
* Assurez-vous que le paramètre iFrame est activé du côté de l'application ; sinon, vous ne pourrez pas l'ouvrir dans l'interface de la plateforme.
  {% endhint %}
  {% endstep %}

{% step %}

## Configurer les paramètres de base

Pour personnaliser votre application, vous pouvez inclure divers paramètres dans l'URL. Vous pouvez ajouter manuellement des paramètres dans le champ URL ou utiliser l'une de nos suggestions : langue, identifiant utilisateur ou fuseau horaire. Cliquez sur une suggestion de paramètre pour l'ajouter à la fin de l'URL. Développez la description ci-dessous pour en savoir plus sur les paramètres suggérés et les exemples.

<details>

<summary>Comprendre les paramètres d'URL suggérés</summary>

Navixy propose quelques paramètres de base pour la personnalisation

1. `?locale={locale_code}`\
   Paramètre de langue qui correspond automatiquement à la langue de la plateforme de l'utilisateur.

* Exemple : `https://your-app.com/dashboard?locale=en`

2. `?user_id={user_identifier}`\
   Paramètre de contexte utilisateur qui transmet l'identité de l'utilisateur pour filtrer les informations personnalisées.

* Exemple : `https://your-app.com/dashboard?user_id=12345`

3. `?timezone={timezone}`\
   Paramètre de fuseau horaire qui correspond automatiquement au fuseau horaire de la plateforme de l'utilisateur.

* Exemple : `https://your-app.com/dashboard?timezone=UTC+1`

Vous pouvez modifier le nom du paramètre suggéré ou lui attribuer une valeur spécifique.

</details>

![Exemple d'URL de l'application avec paramètres](https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-5ef1c1516fcc65f19333029d0918f4a42d1a5605%2FURL_with_Params.png?alt=media\&token=557f4728-dad8-455c-a92a-ddd4fcb43694)

{% hint style="info" %}
Testez votre configuration pour vous assurer que l'application se charge correctement. Cliquez <img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-78171811e50248dd9b883328ca7b69ec6cf767bf%2Fimage-20241217-083119.png?alt=media" alt="image-20241217-083119.png" data-size="line"> pour afficher un aperçu.
{% endhint %}
{% endstep %}

{% step %}

## Ajuster l'apparence

Créez une identité reconnaissable pour votre application afin de la rendre facile d'accès. Les paramètres suivants vous y aideront :

* **Libellé** : Ajoutez un nom unique et descriptif pour votre application (jusqu'à 24 caractères). Il s'affiche dans la barre latérale de la plateforme.
* **Description** : Ajoutez une brève explication détaillant les fonctionnalités de l'application ou mettant en avant des informations importantes (jusqu'à 50 caractères). Une description informative aide vos utilisateurs à mieux comprendre l'objectif de l'application.
* **Icône** : Sélectionnez une icône qui représente la fonction de votre application pour une navigation encore plus intégrée.
  {% endstep %}

{% step %}

## Sélectionner la méthode d'affichage

Décidez comment votre application s'ouvre en choisissant l'une des deux options dans le **Ouvrir dans** menu déroulant :

* **Intégré** : L'application apparaît dans l'interface de la plateforme
* **Nouvel onglet** : L'application s'ouvre dans un onglet de navigateur séparé

{% hint style="info" %}
La plateforme Navixy utilise iFrame pour l'intégration. Comme toutes les URL ne peuvent pas être traitées avec succès par cette technologie, veillez à prévisualiser le résultat de l'intégration. Si vous rencontrez des problèmes avec cette méthode d'affichage, envisagez d'utiliser **Nouvel onglet**.
{% endhint %}
{% endstep %}

{% step %}

## Configurer l'authentification (facultatif)

Configurez l'authentification si votre application s'appuie sur l'API de la plateforme. Dans ce cas, la plateforme fournira directement les données d'authentification à l'application lors de son ouverture, ce qui vous évitera d'implémenter une fonctionnalité de connexion supplémentaire du côté de votre application.\
Vous pouvez choisir l'une des deux méthodes d'authentification :

* **clé API**
  * Cette méthode est destinée aux applications pour lesquelles la gestion des modèles d'accès ou les autorisations des utilisateurs ne sont pas requises.
  * La clé API correspond au niveau d'accès du propriétaire du compte. Cela signifie qu'en fournissant une clé API à un utilisateur standard, vous pouvez lui donner accès à **toutes les données** disponibles pour l'utilisateur principal.\
    Par exemple, si votre application fonctionne avec des appareils GPS auxquels un utilisateur dispose de droits limités ou d'aucun accès, l'utilisation de la clé API expose tout de même tous les appareils GPS du compte principal.
* **Clé de session**
  * Cette méthode est recommandée lorsqu'une gestion des modèles d'accès est impliquée.
  * Transmet la clé de session de l'utilisateur actuel à l'application.

{% hint style="info" %}
La sélection de la **clé API** méthode désactive automatiquement la **Clé de session** méthode, et inversement. Une seule méthode peut être utilisée à la fois.
{% endhint %}

Lorsque l'authentification est activée, la plateforme ajoute `?session_key=` paramètre à l'URL de votre application.

* Si vous avez sélectionné une **clé API**, la valeur du paramètre contient cette clé.
* Si vous avez opté pour une **Clé de session**, la valeur du paramètre inclut la clé de la session utilisateur actuelle à partir de laquelle l'application est consultée.

Assurez-vous que l'application est capable de lire et d'utiliser ce paramètre.
{% endstep %}

{% step %}

## Enregistrez la nouvelle application

Cliquez sur le **Enregistrer** bouton. Votre application apparaît dans la **Applications utilisateur** liste et dans la barre latérale de la plateforme. Les applications activées deviennent automatiquement disponibles pour les utilisateurs du compte.
{% endstep %}
{% endstepper %}

<figure><img src="https://2196179364-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-f3208949947b9860b2bd4665a35ccfa6708d32bb%2Fimage.png?alt=media" alt=""><figcaption><p>Exemple de vue intégrée de l'application utilisateur</p></figcaption></figure>

<details>

<summary>Conseils de dépannage rapides</summary>

Si votre application ne s'affiche pas correctement lorsqu'elle est intégrée, essayez :

* de l'ouvrir dans un nouvel onglet à la place
* de vérifier que votre URL est correcte et accessible
* de vérifier que tous les paramètres sont correctement formatés

</details>

Les applications créées restent entièrement configurables après leur enregistrement. Vous pouvez ajuster leurs paramètres et leur apparence à tout moment. Pour en savoir plus sur la gestion des applications, consultez [Gérer les Applications utilisateur existantes](https://navixy.com/docs/user/fr/guide/account/user-applications/managing-existing-user-applications.md).


---

# 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://navixy.com/docs/user/fr/guide/account/user-applications/creating-new-user-applications.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.
