Documentation API Sharokey - Plateforme de Partage de Secrets Zero Knowledge
🚀 API de Partage de Secrets Sécurisé avec Chiffrement Zero Knowledge
Bienvenue dans la documentation développeur complète de Sharokey, la plateforme de partage de secrets sécurisé avec la technologie de chiffrement Zero Knowledge.
🔐 Sécurité d'abord
Tous les secrets sont chiffrés côté client en utilisant AES-GCM-256 + PBKDF2 (10 000 itérations) avant d'être envoyés à nos serveurs. Nous ne voyons jamais vos données en texte clair.
📚 Ressources Développeur et Librairies API
🔐 Architecture Zero Knowledge
Vue d'ensemble technique de notre système de chiffrement côté client.
En savoir plus →📦 Librairies Clientes
4 librairies officielles : CLI C#, SDK Python, SDK JavaScript, et CDN JavaScript pour une intégration facile.
Parcourir les Librairies →💡 Documentation CLI C#
Outil en ligne de commande multi-plateforme pour l'automatisation, le scripting et l'intégration CI/CD.
Guide CLI →🚀 Exemples de Code
Voir tous les exemples CLI adaptés à chaque librairie avec comparaison côte à côte.
Parcourir les Exemples →⚡ Guide de Démarrage Rapide - Commencer avec l'API Sharokey
Choisissez votre approche de développement préférée pour commencer à utiliser le partage de secrets sécurisé Sharokey :
# Télécharger le CLI
curl -O https://github.com/sharokey/cli/releases/latest/download/sharokey.exe
# Configurer votre token
sharokey config --token VOTRE_TOKEN_API
# Créer votre premier secret
sharokey create "Mon mot de passe secret" --hours 24 --views 1# Installer via pip
pip install sharokey
# Configurer et utiliser
from sharokey import SharokeyClient
client = SharokeyClient(token='VOTRE_TOKEN_API')
secret = await client.create('Mon secret', 24, 1)
print(secret.share_url)# Installer via NPM
npm install Sharokey/sharokey-js
# Configurer et utiliser
import Sharokey from 'sharokey-js';
Sharokey.config({ token: 'VOTRE_TOKEN_API' });
const secret = await Sharokey.create('Mon secret', 24, 1);
console.log(secret.share_url);<!-- Inclure le script -->
<script src="https://cdn.jsdelivr.net/gh/Sharokey/sharokey-cdn@latest/sharokey.js"></script>
<script>
// Configurer et utiliser
Sharokey.config({ token: 'VOTRE_TOKEN_API' });
const secret = await Sharokey.create('Mon secret', 24, 1);
console.log(secret.share_url);
</script>🔐 Architecture de Chiffrement Zero Knowledge - Comment Sharokey Protège Vos Secrets
Comment ça fonctionne :
- Vos données ne quittent jamais votre appareil en texte clair
- Le chiffrement se fait dans votre navigateur/application
- Système à deux clés : CléA (stockée sur le serveur) + CléB (dans l'URL de partage)
- Les deux clés sont requises pour déchiffrer le secret
- Nous ne pouvons pas déchiffrer vos données - vrai Zero Knowledge
🌟 Fonctionnalités de l'API Sharokey - Solution Complète de Gestion des Secrets
| Fonctionnalité | Description |
|---|---|
| 🔐 Zero Knowledge | Chiffrement côté client, nous ne voyons jamais vos secrets |
| 📎 Pièces Jointes | Télécharger des fichiers jusqu'à 10MB avec vos secrets |
| 📱 Protection OTP | Vérification par email et SMS pour une sécurité supplémentaire |
| ⏰ Contrôle d'Expiration | Limites de temps et de vues pour un nettoyage automatique |
| 🌍 Multi-domaines | Domaines personnalisés pour un partage de secrets avec votre marque |
| 📊 Analyses d'Utilisation | Suivre la création et les modèles d'accès des secrets |
| 🔌 API REST | Accès programmatique complet |
| 📚 4 Librairies | CLI, SDK Python, SDK JavaScript, et CDN JavaScript - choisissez votre stack |
🚦 Comment Obtenir Votre Token API Sharokey - Configuration de l'Authentification
- Inscrivez-vous sur sharokey.com
- Allez dans Paramètres → Tokens API
- Créez un nouveau token avec les portées appropriées
- Copiez votre token et gardez-le en sécurité
🔑 Sécurité du Token
Ne committez jamais vos tokens API dans le contrôle de version ou ne les exposez pas dans le code côté client. Stockez-les comme variables d'environnement ou dans des fichiers de configuration sécurisés.
📖 Sections Complètes de la Documentation API
🔐 Implémentation de Sécurité Zero Knowledge
Toutes les librairies clientes implémentent le chiffrement AES-GCM-256 côté client obligatoire. L'API REST brute ne peut pas être utilisée directement en raison de notre architecture Zero Knowledge - garantissant que vos secrets restent privés.
📦 Librairies Clientes Officielles - Support SDK Multi-Langage
Choisissez parmi nos librairies officielles pour différents langages de programmation avec guides d'installation, exemples de code et comparaisons de fonctionnalités :
- Outil CLI C# : Interface en ligne de commande multi-plateforme pour l'automatisation et le scripting
- SDK Python : Package async/await avec annotations de type complètes et gestion d'erreurs
- SDK JavaScript : Package NPM avec support TypeScript et compatibilité Node.js/Navigateur
- Librairie CDN JavaScript : Librairie prête pour le navigateur sans dépendances
🔍 Questions Fréquemment Posées (FAQ)
Qu'est-ce que le chiffrement Zero Knowledge ?
Le chiffrement Zero Knowledge signifie que vos données sont chiffrées sur votre appareil avant transmission. Les serveurs Sharokey ne voient jamais vos secrets en texte clair - nous stockons seulement des données chiffrées que nous ne pouvons pas déchiffrer.
Quels langages de programmation sont supportés ?
Actuellement supportés : C# (outil CLI), Python (SDK), et JavaScript (SDK + librairie CDN). Les quatre librairies fournissent des fonctionnalités et des caractéristiques de sécurité identiques.
Puis-je utiliser Sharokey pour des applications d'entreprise ?
Oui, Sharokey supporte les domaines personnalisés, les analyses d'utilisation, et les fonctionnalités de sécurité de niveau entreprise adaptées aux applications métier.
Quelle est la sécurité de mes secrets ?
Extrêmement sécurisés. Nous utilisons le chiffrement AES-GCM-256 avec dérivation de clé PBKDF2 (10 000 itérations). Même si nos serveurs étaient compromis, vos données resteraient chiffrées et illisibles.
🤝 Support & Communauté
- 📧 Email : [email protected]
- 🐛 Rapports de Bugs : GitHub Issues
- 📖 Blog : Articles techniques
📜 Licence
Cette documentation est publiée sous la Licence MIT.
L'API Sharokey est un service commercial avec un niveau gratuit disponible.