Templates HTML/Markdown - Documentation Passbolt ODIT¶
📄 1. PAGE D'ACCUEIL (index.md)¶
# Bienvenue sur la documentation Passbolt
<p class="text-center text-muted" style="font-size: 1.2rem; margin-bottom: 3rem;">
Votre gestionnaire de mots de passe sécurisé pour ODIT Gouvernance
</p>
<div class="grid">
<div class="card">
<h3>🚀 Démarrage rapide</h3>
<p>Activez votre compte et installez Passbolt sur vos appareils en quelques minutes.</p>
<a href="demarrage/activation/" class="button">Commencer →</a>
</div>
<div class="card">
<h3>💡 Guide d'utilisation</h3>
<p>Apprenez à ajouter, partager et gérer vos mots de passe en toute sécurité.</p>
<a href="utilisation/ajouter-mot-de-passe/" class="button">Découvrir →</a>
</div>
<div class="card">
<h3>🔒 Bonnes pratiques</h3>
<p>Suivez nos recommandations pour une sécurité optimale de vos accès.</p>
<a href="utilisation/bonnes-pratiques/" class="button">En savoir plus →</a>
</div>
<div class="card">
<h3>❓ FAQ & Support</h3>
<p>Trouvez des réponses aux questions fréquentes ou contactez le support.</p>
<a href="faq/" class="button">Consulter →</a>
</div>
</div>
## Pourquoi utiliser Passbolt ?
<div class="highlight-box">
<strong>Passbolt</strong> est un gestionnaire de mots de passe open source conçu pour les équipes. Il vous permet de :
- ✅ Stocker vos mots de passe de manière sécurisée et chiffrée
- ✅ Partager des accès avec vos collègues sans compromettre la sécurité
- ✅ Générer des mots de passe forts automatiquement
- ✅ Accéder à vos identifiants depuis n'importe quel appareil
</div>
## Prochaines étapes
!!! tip "Nouveau sur Passbolt ?"
Commencez par [activer votre compte](demarrage/activation/) suite à l'invitation que vous avez reçue par email.
!!! info "Déjà configuré ?"
Consultez le [guide d'utilisation](utilisation/ajouter-mot-de-passe/) pour maîtriser toutes les fonctionnalités.
---
<p class="text-center text-muted" style="margin-top: 3rem;">
📧 Besoin d'aide ? Contactez le support ODIT : <strong>support@odit.fr</strong>
</p>
📄 2. ACTIVATION DU COMPTE (demarrage/activation.md)¶
# Activation de votre compte Passbolt
<span class="badge badge-primary">Étape 1</span>
## Réception de l'invitation
Vous avez reçu un email d'invitation contenant un lien d'activation. Cet email provient de **noreply@passbolt.odit.fr**.
!!! warning "Important"
Le lien d'activation est **valable 5 jours**. Passé ce délai, vous devrez demander une nouvelle invitation.
## Processus d'activation
### 1. Cliquer sur le lien d'activation
<div class="highlight-box">
📧 Ouvrez l'email d'invitation et cliquez sur le bouton <strong>"Commencer"</strong> ou copiez le lien dans votre navigateur.
</div>
### 2. Créer votre clé de sécurité
Passbolt va générer automatiquement une **clé de sécurité privée** qui servira à chiffrer vos mots de passe.
!!! danger "⚠️ Attention - Étape critique"
Cette clé est **unique** et ne peut pas être régénérée. Vous devez absolument :
- ✅ La télécharger sur votre ordinateur
- ✅ La sauvegarder dans un endroit sûr (clé USB, coffre-fort numérique)
- ✅ Ne jamais la partager avec qui que ce soit
**Sans cette clé, vous perdrez l'accès à tous vos mots de passe !**
### 3. Définir votre mot de passe maître
Le **mot de passe maître** protège votre clé de sécurité. Il vous sera demandé à chaque connexion.
<table>
<thead>
<tr>
<th>Critère</th>
<th>Exigence</th>
</tr>
</thead>
<tbody>
<tr>
<td>Longueur minimale</td>
<td>12 caractères minimum (20+ recommandé)</td>
</tr>
<tr>
<td>Complexité</td>
<td>Majuscules, minuscules, chiffres, symboles</td>
</tr>
<tr>
<td>Unicité</td>
<td>Différent de tous vos autres mots de passe</td>
</tr>
<tr>
<td>Mémorisation</td>
<td>Vous devez pouvoir le retenir sans l'écrire</td>
</tr>
</tbody>
</table>
!!! tip "Astuce - Passphrase"
Utilisez une **phrase secrète** facile à retenir mais difficile à deviner :
❌ Mauvais : `Passbolt2024!`
✅ Bon : `MonChatAdore-Manger-DesSardines-À17h!`
### 4. Token de sécurité (optionnel)
Passbolt peut ajouter une image de sécurité qui s'affichera à chaque connexion pour confirmer que vous êtes bien sur le bon site.
## Validation finale
Une fois ces étapes complétées :
1. ✅ Votre compte est activé
2. ✅ Vous pouvez vous connecter à Passbolt
3. ✅ Il est temps d'installer l'extension navigateur
<div style="text-align: center; margin-top: 2rem;">
<a href="../installation-pc/" class="button">Suivant : Installation PC →</a>
</div>
---
!!! question "Problème d'activation ?"
Consultez la section [FAQ](../../faq/#activation) ou contactez le support.
📄 3. INSTALLATION PC (demarrage/installation-pc.md)¶
# Installation sur PC
<span class="badge badge-primary">Étape 2</span>
## Extension navigateur
Passbolt fonctionne via une extension de navigateur qui s'intègre directement à vos sites web.
### Navigateurs compatibles
<div class="grid">
<div class="card">
<h3>🌐 Chrome / Edge</h3>
<p>Extension disponible sur le Chrome Web Store</p>
<a href="https://chrome.google.com/webstore" target="_blank" class="button-outline">Télécharger</a>
</div>
<div class="card">
<h3>🦊 Firefox</h3>
<p>Extension disponible sur Firefox Add-ons</p>
<a href="https://addons.mozilla.org" target="_blank" class="button-outline">Télécharger</a>
</div>
<div class="card">
<h3>🧭 Brave</h3>
<p>Compatible avec l'extension Chrome</p>
<a href="https://chrome.google.com/webstore" target="_blank" class="button-outline">Télécharger</a>
</div>
</div>
## Installation pas à pas
### 1. Télécharger l'extension
1. Accédez au store de votre navigateur (liens ci-dessus)
2. Recherchez **"Passbolt"**
3. Cliquez sur **"Ajouter à [Navigateur]"**
### 2. Configurer l'extension
Une fois l'extension installée, une icône Passbolt apparaît dans votre barre d'outils.
!!! info "Première connexion"
1. Cliquez sur l'icône Passbolt
2. Importez votre **clé de sécurité privée** (fichier téléchargé lors de l'activation)
3. Entrez votre **mot de passe maître**
4. L'extension se connecte automatiquement à **passbolt.odit.fr**
### 3. Vérification de l'installation
Pour vérifier que tout fonctionne :
## Utilisation quotidienne
### Remplissage automatique
<div class="highlight-box">
Lorsque vous visitez un site pour lequel vous avez un mot de passe enregistré, Passbolt détecte automatiquement les champs de connexion et propose de les remplir.
</div>
1. Rendez-vous sur le site web
2. Cliquez dans le champ de connexion
3. Sélectionnez l'identifiant proposé par Passbolt
4. Entrez votre mot de passe maître si demandé
5. Le formulaire est rempli automatiquement ✨
### Raccourcis clavier
| Raccourci | Action |
|-----------|--------|
| `Ctrl/Cmd + Shift + P` | Ouvrir Passbolt |
| `Ctrl/Cmd + Shift + F` | Rechercher un mot de passe |
| `Ctrl/Cmd + Shift + N` | Nouveau mot de passe |
!!! tip "Astuce productivité"
Épinglez l'extension Passbolt dans votre barre d'outils pour un accès rapide !
<div style="text-align: center; margin-top: 2rem;">
<a href="../installation-mobile/" class="button">Suivant : Installation Mobile →</a>
</div>
📄 4. AJOUTER UN MOT DE PASSE (utilisation/ajouter-mot-de-passe.md)¶
# Ajouter un mot de passe
Apprenez à stocker un nouveau mot de passe dans Passbolt de manière sécurisée.
## Méthode 1 : Via l'extension navigateur
### Depuis un site web
La méthode la plus simple consiste à laisser Passbolt détecter automatiquement un nouveau login.
1. **Connectez-vous normalement** sur le site web
2. Remplissez vos identifiants et connectez-vous
3. **Passbolt détecte** le nouveau mot de passe et propose de l'enregistrer
4. Cliquez sur **"Enregistrer"**
5. Choisissez un dossier et ajoutez des informations (optionnel)
!!! success "Enregistrement automatique"
Passbolt enregistre automatiquement l'URL, le nom d'utilisateur et le mot de passe. Plus besoin de tout ressaisir !
### Manuellement depuis l'extension
Si Passbolt n'a pas détecté le site automatiquement :
1. Cliquez sur l'icône Passbolt dans votre navigateur
2. Cliquez sur **"+ Nouveau mot de passe"**
3. Remplissez les informations :
<table>
<thead>
<tr>
<th>Champ</th>
<th>Description</th>
<th>Obligatoire</th>
</tr>
</thead>
<tbody>
<tr>
<td>Nom</td>
<td>Titre descriptif (ex: "Gmail Pro")</td>
<td>✅ Oui</td>
</tr>
<tr>
<td>URL</td>
<td>Adresse du site web</td>
<td>⚠️ Recommandé</td>
</tr>
<tr>
<td>Nom d'utilisateur</td>
<td>Login, email ou identifiant</td>
<td>⚠️ Recommandé</td>
</tr>
<tr>
<td>Mot de passe</td>
<td>Le mot de passe à sauvegarder</td>
<td>✅ Oui</td>
</tr>
<tr>
<td>Description</td>
<td>Notes complémentaires</td>
<td>❌ Non</td>
</tr>
</tbody>
</table>
## Méthode 2 : Via l'interface web
Connectez-vous à **passbolt.odit.fr** et créez un mot de passe depuis l'interface complète.
### Avantages de l'interface web
- 🔍 Vue d'ensemble de tous vos mots de passe
- 📁 Organisation en dossiers personnalisés
- 👥 Gestion des partages avancée
- 📊 Historique et audit des accès
## Générer un mot de passe sécurisé
!!! tip "Générateur intégré"
Passbolt inclut un générateur de mots de passe forts. Utilisez-le systématiquement !
### Paramètres recommandés
Lors de la création d'un nouveau mot de passe, Passbolt propose un générateur avec ces options :
<div class="grid">
<div class="card">
<h3>Longueur</h3>
<p><strong>18-24 caractères</strong></p>
<p class="text-muted">Plus c'est long, mieux c'est !</p>
</div>
<div class="card">
<h3>Caractères</h3>
<p><strong>Tous activés</strong></p>
<p class="text-muted">A-Z, a-z, 0-9, symboles</p>
</div>
<div class="card">
<h3>Type</h3>
<p><strong>Aléatoire</strong></p>
<p class="text-muted">Maximum de sécurité</p>
</div>
</div>
```plaintext
Exemple de mot de passe généré :
k9$mP2@xQz7!vN4&wL8^sR1#
✅ 24 caractères
✅ Mélange de majuscules, minuscules, chiffres, symboles
✅ Entropie élevée (impossible à deviner)
Organisation des mots de passe¶
Créer des dossiers¶
Organisez vos mots de passe par catégorie :
- 📧 Emails professionnels
- 🌐 Sites web clients
- 💼 Outils internes ODIT
- 🔧 Services IT / Admin
- 🏦 Accès financiers
Ajouter des tags¶
Utilisez des tags pour retrouver facilement vos mots de passe :
#urgent #partagé #client-X #backup
Recherche rapide
La barre de recherche Passbolt indexe les noms, URLs, descriptions et tags !
Bonnes pratiques¶
✅ **À FAIRE**
- Utiliser le générateur de mots de passe
- Créer un mot de passe unique par service
- Ajouter une description si nécessaire (ex: "Compte admin")
- Vérifier l'URL avant de sauvegarder
❌ **À ÉVITER**
- Réutiliser le même mot de passe
- Utiliser des mots de passe faibles (prénoms, dates...)
- Sauvegarder le mot de passe maître dans Passbolt
- Partager un accès sans réfléchir aux permissions
---
## 📄 5. FAQ (faq.md)
```markdown
# FAQ & Support
Retrouvez ici les réponses aux questions les plus fréquentes.
## 🚀 Activation & Installation
### J'ai perdu le lien d'activation, que faire ?
!!! question "Réponse"
Contactez le support ODIT (support@odit.fr) pour recevoir une nouvelle invitation. Le délai de traitement est généralement de 24h.
### Puis-je utiliser Passbolt sur plusieurs ordinateurs ?
!!! question "Réponse"
Oui ! Vous devez installer l'extension sur chaque navigateur et **importer votre clé privée** sur chaque appareil. Conservez bien votre fichier de clé dans un endroit sécurisé.
### L'extension n'apparaît pas dans mon navigateur
!!! question "Réponse"
Vérifiez que :
1. L'extension est bien installée (vérifiez dans les paramètres du navigateur)
2. L'extension n'est pas désactivée
3. Vous avez épinglé l'icône dans la barre d'outils
Si le problème persiste, désinstallez puis réinstallez l'extension.
---
## 🔐 Sécurité & Mot de passe maître
### Que faire si j'oublie mon mot de passe maître ?
!!! danger "Réponse importante"
**Il n'y a malheureusement aucune solution de récupération** si vous oubliez votre mot de passe maître. Par conception, Passbolt ne peut pas réinitialiser votre mot de passe car tout est chiffré localement.
Vous devrez créer un nouveau compte et perdrez l'accès à tous vos mots de passe précédents.
💡 **Conseil** : Utilisez une phrase secrète mémorable et notez-la dans un coffre-fort physique si nécessaire.
### Que faire si je perds ma clé privée ?
!!! danger "Réponse importante"
Même problème que pour le mot de passe maître : **impossible de récupérer vos données** sans la clé privée.
⚠️ **Sauvegardez votre clé privée** sur :
- Une clé USB stockée en lieu sûr
- Un gestionnaire de fichiers chiffrés (Cryptomator, VeraCrypt)
- Un coffre-fort numérique sécurisé
### Passbolt peut-il voir mes mots de passe ?
!!! question "Réponse"
**Non**. Tout est chiffré de bout en bout. Même les administrateurs ODIT ne peuvent pas voir vos mots de passe. Seul votre mot de passe maître peut les déchiffrer.
---
## 👥 Partage & Collaboration
### Comment partager un mot de passe avec un collègue ?
!!! question "Réponse"
Consultez le guide [Partager un accès](../utilisation/partager-acces/) pour la procédure complète.
### Puis-je limiter les droits d'un collègue ?
!!! question "Réponse"
Oui ! Lors du partage, vous pouvez définir deux niveaux de permission :
- **Lecture seule** : La personne peut voir et utiliser le mot de passe mais ne peut pas le modifier
- **Modification** : La personne peut modifier et supprimer le mot de passe
### Que se passe-t-il si je révoque un partage ?
!!! question "Réponse"
La personne perd immédiatement l'accès au mot de passe. Elle ne pourra plus le voir ni l'utiliser.
---
## 📱 Mobile
### Passbolt fonctionne-t-il sur smartphone ?
!!! question "Réponse"
Oui ! Téléchargez l'application officielle :
- 📱 **iOS** : App Store
- 🤖 **Android** : Google Play Store
Consultez le guide [Installation Mobile](../demarrage/installation-mobile/) pour plus de détails.
---
## 🛠️ Problèmes techniques
### Passbolt ne remplit pas automatiquement les champs
!!! question "Réponse"
Vérifiez que :
1. L'URL enregistrée correspond bien au site visité
2. L'extension a les permissions nécessaires sur le site
3. Le site n'utilise pas un formulaire de connexion non-standard
En dernier recours, copiez manuellement le mot de passe depuis l'extension.
### Message d'erreur "Clé invalide"
!!! question "Réponse"
Cela signifie généralement que :
- Vous avez importé la mauvaise clé privée
- Le fichier de clé est corrompu
- Vous essayez d'importer une clé sur le mauvais compte
Vérifiez que vous utilisez bien le bon fichier `.asc` correspondant à votre compte.
---
## 📞 Contact & Support
<div class="grid">
<div class="card">
<h3>📧 Email</h3>
<p><strong>support@odit.fr</strong></p>
<p class="text-muted">Réponse sous 24-48h</p>
</div>
<div class="card">
<h3>💬 Chat interne</h3>
<p><strong>Slack - #passbolt-support</strong></p>
<p class="text-muted">Réponse rapide pendant les heures de bureau</p>
</div>
<div class="card">
<h3>📚 Documentation</h3>
<p><strong>docs.passbolt.odit.fr</strong></p>
<p class="text-muted">Guides complets et tutoriels</p>
</div>
<div class="card">
<h3>🎫 Ticket IT</h3>
<p><strong>ServiceDesk ODIT</strong></p>
<p class="text-muted">Pour les problèmes complexes</p>
</div>
</div>
---
!!! tip "Vous ne trouvez pas de réponse ?"
N'hésitez pas à contacter le support. Aucune question n'est stupide, la sécurité de vos données est notre priorité !
📄 6. CONFIGURATION MKDOCS (mkdocs.yml)¶
site_name: Documentation Passbolt ODIT
site_description: Guide d'utilisation de Passbolt pour ODIT Gouvernance
site_author: ODIT Gouvernance
site_url: https://docs.passbolt.odit.fr
theme:
name: material
language: fr
palette:
scheme: default
logo: assets/logo.png
favicon: assets/favicon.ico
features:
- navigation.instant
- navigation.tracking
- navigation.tabs
- navigation.sections
- navigation.expand
- navigation.top
- search.suggest
- search.highlight
- content.code.copy
- content.tabs.link
extra_css:
- stylesheets/custom.css
extra_javascript:
- javascripts/extra.js
plugins:
- search:
lang: fr
markdown_extensions:
- admonition
- pymdownx.details
- pymdownx.superfences
- pymdownx.tabbed:
alternate_style: true
- pymdownx.emoji:
emoji_index: !!python/name:material.extensions.emoji.twemoji
emoji_generator: !!python/name:material.extensions.emoji.to_svg
- attr_list
- md_in_html
- tables
- toc:
permalink: true
nav:
- Accueil: index.md
- Démarrage:
- Activation du compte: demarrage/activation.md
- Installation PC: demarrage/installation-pc.md
- Installation Mobile: demarrage/installation-mobile.md
- Utilisation:
- Ajouter un mot de passe: utilisation/ajouter-mot-de-passe.md
- Partager un accès: utilisation/partager-acces.md
- Bonnes pratiques: utilisation/bonnes-pratiques.md
- FAQ & Support: faq.md
extra:
social:
- icon: fontawesome/solid/envelope
link: mailto:support@odit.fr
name: Support ODIT
Support
Si vous avez un souci (invitation, accès, extension, mobile), contactez Ahmed EL ABAIDI / ahmed.elabaidi@oditgouvernance.com.