> For the complete documentation index, see [llms.txt](https://docs.medcrypt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.medcrypt.com/fr/guardian/understand-device-provisioning/begin-device-provisioning.md).

# Commencer le provisionnement des dispositifs

## Présentation du provisionnement des appareils

Le provisionnement d’un appareil nécessite des échanges avec Guardian Cloud. Si l’appareil de provisionnement est directement connecté à Guardian Cloud, on parle de provisionnement **connecté**  . Si l’appareil de provisionnement n’est pas directement connecté à Guardian Cloud, on parle de provisionnement **déconnecté**  . **Proxy** Le provisionnement par proxy est un cas particulier dans lequel un appareil capable d’effectuer un provisionnement connecté peut transmettre une Provision Request pour un appareil effectuant un provisionnement déconnecté.

## Prérequis généraux

Avant de commencer le provisionnement des appareils, vérifiez que vous avez :

* un compte Guardian ;
* créé et configuré votre système dans Guardian ;
* reçu votre package de provisionnement de Medcrypt ;
* téléchargé et installé Guardian Library pour votre plateforme ;
* installé le package de provisionnement sur votre appareil.

Consultez la méthode que vous utiliserez pour connaître les prérequis supplémentaires.

## Méthodes de provisionnement

Choisissez la méthode de provisionnement la mieux adaptée à la connectivité et aux exigences d’intégration de votre appareil :

* [**Provisionner à l’aide de Guardian API**](/fr/guardian/api-overview/api-reference/classes/classmedcrypt-guardian-guardian.md#device-provisioning-functions)**:** Utilisez directement Guardian Library dans le code de votre application pour contrôler entièrement le processus de provisionnement par programmation. Cette méthode convient particulièrement aux appareils nécessitant une intégration poussée avec les opérations cryptographiques de Guardian.
* [**Provisionner via l’interface utilisateur**](#provision-via-the-ui)**:** Utilisez l’interface Web Guardian pour téléverser manuellement les demandes de provisionnement et télécharger les profils certifiés.
  * **Appareils déconnectés :** Idéal pour les appareils sans connectivité réseau, pour lesquels les techniciens sur le terrain effectuent manuellement les transferts de fichiers.
* [**Provisionner à l’aide de la ligne de commande**](#provision-via-the-command-line)**:** Utilisez l’utilitaire `mcguard_provision` pour les tests, les appareils qui ne peuvent pas intégrer Guardian Library ou les configurations de provisionnement par proxy :
  * **Appareils connectés :** Appareils disposant d’une connectivité réseau et pouvant communiquer directement avec Guardian Cloud.
  * **Appareils déconnectés :** Provisionnement hors ligne lorsque les appareils ne disposent d’aucune connectivité réseau.
  * **Provisionnement par proxy :** Utilisez l’utilitaire avec un appareil passerelle qui sert de proxy pour d’autres appareils sans accès direct à Internet.

### Contenu de cette rubrique

* **Provisionnement déconnecté :** Les utilisateurs peuvent utiliser la ligne de commande ou la page [Provisioning](/fr/guardian/understand-device-provisioning/begin-device-provisioning.md) pour soumettre des demandes de provisionnement (PR) et télécharger des profils certifiés (CP). Ils peuvent ensuite gérer le provisionnement des appareils et exporter le rapport de provisionnement des appareils depuis la page **Devices** . Il s’agit d’une solution provisoire, le temps que nous ajoutions la prise en charge complète du cycle de vie du provisionnement à la page **Devices** . Pour consulter la procédure complète, reportez-vous à [Comprendre le provisionnement des appareils](/fr/guardian/understand-device-provisioning.md).
* **Provisionnement connecté :** Les appareils soumettent automatiquement des demandes à la page [Devices](/fr/guardian/understand-device-provisioning/manage-device-provisioning.md) et Guardian envoie automatiquement un CP à l’appareil correspondant.
* **Provisionnement par proxy :** Un proxy est provisionné, puis utilisé pour provisionner d’autres appareils.

## Types et extensions de fichiers Guardian

Guardian utilise plusieurs types de fichiers, dotés d’extensions spécifiques, au cours du processus de provisionnement :

**Provision Request :** Fichier utilisé pour transmettre des informations, notamment des clés publiques, au système dorsal de Guardian Cloud. Il contient les demandes de signature de certificat (CSR) envoyées à Guardian Cloud. Extension : `.mcpr`

**TrustStore :** Ancres de confiance de la plateforme Guardian. Extension : `.mcts`

**Fichiers de profil :**

1. **Profil certifié à provisionner :** Instructions et configuration signées pour la bibliothèque Guardian et les opérations de provisionnement. Il s’agit du modèle de profil initial créé pour ce type d’appareil pendant le processus de provisionnement. Extension : `.mcpp`
2. **Profil certifié :** Instructions et configuration signées pour l’exécution de la bibliothèque Guardian et les opérations de reprovisionnement. Il s’agit du profil final de l’appareil créé pendant le processus de provisionnement. Extension : `.mcp`

**Fichiers d’identité :**

1. **Identité privée à provisionner :** Matériel de clé pour les opérations de provisionnement initial et les connexions. Il s’agit du modèle d’identité privée initial. Extension : `.mcpip`
2. **Identité privée :** Matériel de clé pour les opérations et les connexions de reprovisionnement et d’exécution. Il s’agit du fichier d’identité privée final, qui contient les clés privées conservées sur l’appareil. Extension : `.mcpi`

### Utilisation des fichiers selon le type d’opération

**Fichiers utilisés pendant le provisionnement :**

* TrustStore
* Identité privée pour le provisionnement
* Profil certifié pour le provisionnement

**Fichiers utilisés pendant le reprovisionnement :**

* TrustStore
* Identité privée
* Profil certifié

Fichiers utilisés lors de l’exécution

* TrustStore
* Identité privée
* Profil certifié

## Étapes générales de provisionnement

### 1. Générer les clés de l’appareil et la demande de provisionnement (PR)

* Cette étape est effectuée sur l’appareil de provisionnement afin de garantir une sécurité maximale des clés.
* Peut être effectuée à l’aide de l’API de la bibliothèque Guardian ou de l’utilitaire `mcguard_provision` CLI
* Une PR contient un ensemble de plusieurs demandes de signature de certificat (CSR), avec toutes les informations nécessaires pour que Guardian Cloud émette le profil provisionné et les certificats correspondants.
  * Une CSR contient :
    * **Clé publique** - la clé cryptographique qui sera intégrée au certificat émis
    * **Informations d’identité** - des renseignements tels que le nom de l’organisation, l’identifiant de l’appareil et l’usage prévu
    * **Signature numérique** - prouve que le demandeur possède la clé privée correspondante
  * Fonctionnement des CSR :
    1. L’appareil génère une paire de clés publique et privée
    2. L’appareil crée une CSR contenant la clé publique et les informations d’identité
    3. L’appareil signe la CSR avec sa clé privée
    4. La CSR est envoyée à l’autorité de certification (Guardian Cloud dans votre cas)
    5. L’autorité de certification valide la demande et émet un certificat
    6. La clé privée ne quitte jamais l’appareil
* Les clés sont stockées dans l’identité privée générée.

### 2. Soumettre la PR à Guardian Cloud

* **Provisionnement connecté :**
  * API ou CLI : utilisez l’API de la bibliothèque Guardian ou `mcguard_provision` un utilitaire CLI pour envoyer automatiquement la PR générée à Guardian Cloud et récupérer le profil certifié correspondant, achevant ainsi le provisionnement de l’appareil.
* **Provisionnement déconnecté :** Téléversez la PR générée à l’aide de l’interface utilisateur de Guardian Cloud.

### 3. Récupérer le profil certifié (CP) depuis Guardian Cloud

* **Provisionnement connecté :**
  * CLI : une fois la PR de l’appareil traitée, son profil certifié est automatiquement récupéré.
  * API : utilisez l’API de la bibliothèque Guardian pour récupérer le profil certifié.
* **Provisionnement déconnecté :** Téléchargez le profil certifié délivré depuis l’interface utilisateur de Guardian Cloud, puis installez-le sur l’appareil correspondant.

## Provisionner via l’interface utilisateur

### Méthode de provisionnement déconnecté

Utilisez cette méthode lorsque les appareils ne sont pas connectés au réseau et que les techniciens de terrain doivent gérer manuellement les transferts de fichiers.

**Prérequis supplémentaires :**

* Demande de provisionnement (fichier .mcpr) extraite de votre appareil

**Étapes du provisionnement déconnecté :**

Vous pouvez lancer le processus de provisionnement depuis la page **Provisioning** puis [gérer le provisionnement](/fr/guardian/understand-device-provisioning/manage-device-provisioning.md) depuis la page Devices.

1. **Extraire la PR de l’appareil :** Le technicien de terrain extrait la demande de provisionnement (fichier `.mcpr` ) générée par l’appareil.
2. Sélectionnez un nom de système dans les menus déroulants de filtre rapide de cette page. Vous ne pouvez sélectionner qu’un seul nom de système, également appelé définition de système.
3. Après vous être connecté à Guardian, cliquez sur l’élément **Provisioning** dans la barre latérale.
4. Cliquez sur le bouton **Begin provisioning** . Vous serez invité à téléverser une demande de provisionnement. Il s’agit d’un fichier `.mcpr` .
5. **Suivre l’approbation :** La PR apparaîtra sur la page [Devices](/fr/guardian/understand-device-provisioning/manage-device-provisioning.md) pour suivre le processus d’approbation et de traitement.
   * **Systèmes avec approbation automatique :** Guardian fera automatiquement avancer les PR des appareils dans le processus d’approbation, puis enverra directement à chaque appareil son profil certifié (CP).
   * **Systèmes avec approbation manuelle :** Votre équipe approuvera ou rejettera manuellement la demande, puis achèvera le provisionnement manuellement.
6. **Télécharger le profil (mode déconnecté) :** Une fois la demande de provisionnement traitée, vous serez invité à télécharger le profil certifié, ou CP (fichier `.mcp` ), depuis la page **Provisioning** .
7. **Achever le provisionnement (mode déconnecté) :** Le CP est téléchargé manuellement depuis la [Provisionnement](/fr/guardian/understand-device-provisioning/begin-device-provisioning.md) page, puis installés manuellement sur l’appareil. Cliquez sur **Terminer le provisionnement** pour le marquer comme **Provisioned** dans Guardian.

### Méthode de provisionnement avec connexion

Les appareils connectés envoient automatiquement leurs demandes de provisionnement (PR) à Guardian Cloud.

* Systèmes avec approbation automatique : Guardian fait automatiquement avancer les PR des appareils dans le processus d’approbation, puis envoie directement à chaque appareil son profil certifié (CP).
* Systèmes avec approbation manuelle : votre équipe approuve ou rejette manuellement les demandes, puis termine manuellement le provisionnement sur la page [Appareils](/fr/guardian/understand-device-provisioning/manage-device-provisioning.md) .

Pour les deux types d’approbation, le CP est automatiquement téléchargé depuis Guardian et installé sur l’appareil, puis celui-ci est automatiquement marqué comme **Provisioned** dans Guardian.

## Provisionner via la ligne de commande

Utilisez l’outil `mcguard_provision` pour tester les flux de provisionnement, pour les appareils qui ne peuvent pas intégrer Guardian Library ou pour les configurations de provisionnement par proxy.

L’outil de ligne de commande prend en charge :

* les appareils connectés disposant d’une connexion réseau
* les appareils déconnectés nécessitant un provisionnement hors ligne
* les scénarios de proxy dans lesquels une passerelle gère le provisionnement d’autres appareils

Pour connaître la syntaxe complète des commandes, consulter des exemples et obtenir des conseils de dépannage, voir [Provisionner des appareils via la ligne de commande](/fr/guardian/understand-device-provisioning/begin-device-provisioning/provision-devices-using-command-line.md).

## Provisionner via l’API

Vous pouvez [provisionner un appareil à l’aide de l’API Guardian](/fr/guardian/understand-device-provisioning/begin-device-provisioning/provision-devices-using-api.md), notamment configurer l’appareil, générer des identifiants sécurisés et établir des connexions de confiance. Pour ce faire, vous devez intégrer Guardian Library au code de votre application. Cela vous permet de contrôler entièrement le processus de provisionnement par programmation, au moyen d’appels de fonction plutôt qu’avec des outils externes ou des étapes manuelles.

L’API prend en charge les flux de provisionnement avec connexion, sans connexion et par proxy. Pour obtenir des informations complètes sur la mise en œuvre, la documentation des fonctions et des exemples de code, voir [Provisionner des appareils via l’API](/fr/guardian/understand-device-provisioning/begin-device-provisioning/provision-devices-using-api.md).

#### Quand utiliser l’API :

* Vous devez intégrer directement la logique de provisionnement au logiciel de votre appareil.
* Vous avez besoin de flux de provisionnement automatisés, sans intervention manuelle.
* Vous avez besoin d’un contrôle précis du processus de provisionnement.
* Vous devez vous intégrer aux systèmes de gestion des appareils existants.

## Débogage et journalisation

Guardian ne crée pas de fichiers journaux. La journalisation est plutôt contrôlée par l’application :

* Guardian écrit les journaux dans `stdout` et `stderr`, qui s’affichent dans le terminal/la CLI de l’application en cours d’exécution. Recherchez dans la sortie les codes d’erreur spécifiques ou les échecs de connexion.
* **Journalisation personnalisée :** Utilisez `SetLoggingCallback` pour rediriger les messages de journalisation vers une fonction de rappel, interrompre leur affichage dans le terminal et permettre un traitement personnalisé des journaux
* **Contrôle de la journalisation :** Les applications peuvent contrôler le niveau et le degré de détail de la journalisation.
* **Interface utilisateur de Guardian Cloud**: Consultez l’interface Guardian Cloud pour obtenir des détails supplémentaires sur les erreurs et connaître l’état du provisionnement.


---

# 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.medcrypt.com/fr/guardian/understand-device-provisioning/begin-device-provisioning.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.