API 1Password Connect

Description de l'API 1Password

La documentation officielle de 1Password Connect Server présente une API dédiée à l'accès programmatique aux vaults et aux items, avec des fonctions comme la liste des coffres, la récupération des détails d'un coffre, l'ajout, la lecture, la mise à jour et la suppression d'un élément, ainsi que la gestion des fichiers et l'historique des appels API. L'accès s'effectue via un jeton d'authentification et s'inscrit dans un workflow de Secrets Automation.

Qu'est-ce que l'API 1Password ?

L'API 1Password est une interface conçue pour permettre aux développeurs d'interagir avec les coffres 1Password depuis des applications, des scripts ou des systèmes d'automatisation. Elle sert notamment à centraliser les secrets dans un environnement sécurisé tout en facilitant leur intégration dans des services internes, des applications cloud et des chaînes de déploiement.

Caractéristiques de l'API 1Password

• Couverture des coffres et des items : l'API permet de lister les vaults, de consulter leurs détails, de parcourir les items et de gérer leurs versions.
• Gestion complète du cycle de vie : elle autorise l'ajout, la lecture, la mise à jour partielle, le remplacement et la suppression d'un item.
• Support des fichiers : l'API permet de lister les fichiers associés à un item, d'en consulter les détails et de récupérer leur contenu.
• Supervision et traçabilité : un endpoint dédié permet de consulter l'activité de l'API, ce qui est utile pour l'audit et le suivi des opérations.
• Sécurité et authentification : chaque requête doit être authentifiée avec un access token, ce qui renforce le contrôle d'accès.
• Intégration DevOps : 1Password met en avant l'accès aux secrets via une API REST privée et la CLI, ce qui convient aux environnements d'automatisation modernes.

Comment intégrer l'API 1Password : Exemple d'implémentation

Voici des exemples de code simples pour récupérer les coffres d'un environnement 1Password Connect. Avant toute requête, il faut disposer d'un access token valide et d'un Connect Server déployé dans son infrastructure.

const axios = require('axios');

const API_TOKEN = 'YOUR_ACCESS_TOKEN';
const API_URL = 'https://your-connect-server/v1/vaults';

async function listVaults() {
  try {
    const response = await axios.get(API_URL, {
      headers: {
        Authorization: `Bearer ${API_TOKEN}`,
        'Content-Type': 'application/json'
      }
    });
    return response.data;
  } catch (error) {
    console.error('Erreur lors de la récupération des coffres 1Password :', error.response?.data || error.message);
    throw error;
  }
}

// Exemple d'utilisation
// listVaults().then(data => console.log(data));
                

import requests

API_TOKEN = 'YOUR_ACCESS_TOKEN'
API_URL = 'https://your-connect-server/v1/vaults'

def list_vaults():
    headers = {
        'Authorization': f'Bearer {API_TOKEN}',
        'Content-Type': 'application/json'
    }
    response = requests.get(API_URL, headers=headers)
    if response.status_code == 200:
        return response.json()
    raise Exception(f"Erreur lors de la récupération des coffres 1Password: {response.status_code} - {response.text}")

# Exemple d'utilisation
# data = list_vaults()
# print(data)
                

-- php --
$apiToken = 'YOUR_ACCESS_TOKEN';
$apiUrl = 'https://your-connect-server/v1/vaults';

function listVaults($apiUrl, $apiToken) {
    $ch = curl_init($apiUrl);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: Bearer ' . $apiToken,
        'Content-Type: application/json'
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode === 200) {
        return json_decode($response, true);
    }

    throw new Exception("Erreur lors de la récupération des coffres 1Password: $httpCode - $response");
}

// Exemple d'utilisation
// $data = listVaults($apiUrl, $apiToken);
// print_r($data);
?>
                

Idées d'utilisation de l'API 1Password

• Automatisation DevOps : injecter des secrets dans les pipelines CI/CD sans exposer les identifiants en clair.
• Gestion centralisée des credentials : stocker et retrouver des clés API, mots de passe et notes sécurisées depuis les outils métiers.
• Supervision des accès : analyser l'activité des requêtes API pour renforcer la gouvernance et l'audit interne.
• Intégration applicative : connecter des applications internes à un coffre sécurisé pour lire ou mettre à jour des secrets à la demande.
• Administration des fichiers sensibles : gérer des fichiers confidentiels associés à des items, avec consultation ou téléchargement selon les besoins.