VISO TRUST

Serveur MCP VISO TRUST

Un serveur Model Context Protocol (MCP) pour intégrer les capacités de l'API VISO TRUST avec les assistants IA.

Serveur distant hébergé

VISO TRUST héberge une instance gérée de ce serveur MCP, vous n'avez donc rien à construire, exécuter ou auto-héberger pour commencer :

https://mcp.visotrust.com/mcp

Connectez n'importe quel client MCP à ce point de terminaison en utilisant le transport Streamable HTTP et authentifiez-vous avec votre jeton API VISO TRUST. Pour savoir comment générer un jeton API, consultez la documentation de support VISO TRUST.

Exemple de configuration client :

{
    "mcpServers": {
        "viso-mcp": {
            "type": "streamable-http",
            "url": "https://mcp.visotrust.com/mcp",
            "headers": {
                "Authorization": "Bearer <your-api-token>"
            }
        }
    }
}

Pour tester le point de terminaison hébergé avec MCP Inspector, exécutez npx @modelcontextprotocol/inspector, définissez Transport Type sur Streamable HTTP et utilisez l'URL ci-dessus.

Le reste de ce document explique comment exécuter le serveur vous-même (localement ou dans votre propre infrastructure).

Prérequis

• Java 21+
• Gradle
• Docker (optionnel pour le déploiement conteneurisé)
• MCP Inspector (optionnel pour les tests)

Configuration

Configuration de l'API VISO TRUST

Les propriétés suivantes peuvent être configurées pour l'API VISO TRUST :

• visotrust.api.base-url : L'URL de base pour l'API VISO TRUST (par défaut : http://localhost:8080)
• visotrust.api.token : Votre jeton API de la plateforme VISO TRUST (obligatoire)
• visotrust.api.timeout : Délai d'expiration de la requête API en millisecondes (par défaut : 30000)
• visotrust.api.connect-timeout : Délai d'expiration de la connexion API en millisecondes (par défaut : 5000)

Pour savoir comment générer un jeton API pour la variable d'environnement visotrust.api.token, consultez la documentation de support VISO TRUST.

Profils d'application

Cette application prend en charge les profils Spring Boot pour activer différentes configurations selon les scénarios de déploiement.

Profil distant

Le profil remote est conçu pour la prise en charge MCP distante via le transport Streamable HTTP. Ce profil exécute le serveur comme une application web afin qu'il puisse communiquer avec les clients distants via HTTP. (Streamable HTTP remplace le transport SSE obsolète ; ici, il est configuré en mode sans état.)

Différences clés du profil distant :

• Fonctionne comme une application web servlet (Tomcat) sur le port 3001 au lieu des entrées/sorties standard
• Expose le point de terminaison MCP à POST /mcp (Streamable HTTP)
• Fonctionne en mode sans état — aucun état de serveur par session, ce qui permet une mise à l'échelle horizontale derrière un équilibreur de charge sans affinité de session requise
• Paramètres de serveur optimisés pour les connexions client distantes
• Journalisation améliorée pour le débogage distribué

Remarque : Les clients se connectent au point de terminaison Streamable HTTP unique …/mcp. Les anciens points de terminaison SSE (/sse + /mcp/message) ne sont plus servis.

Comment activer le profil distant :

Lors de l'exécution directe avec Java :

java -jar viso-mcp-server-<version>.jar --spring.profiles.active=remote

Lors de l'exécution avec Gradle :

./gradlew bootRun --args="--spring.profiles.active=remote"

Lors de l'utilisation de Docker :

docker run -i --rm \
  -e VISOTRUST_API_TOKEN=<your-api-token> \
  -e SPRING_PROFILES_ACTIVE=remote \
  viso-mcp-server

Quand utiliser le profil distant :

• Lors du déploiement du serveur MCP sur un serveur distant ou un environnement cloud
• Lorsque les clients se connecteront via Streamable HTTP plutôt qu'en stdio direct
• Lorsque vous avez besoin d'une journalisation et d'une surveillance améliorées pour les déploiements distribués
• Lors de l'intégration avec des assistants IA basés sur le web qui se connectent via Streamable HTTP

Pour le développement local et la communication stdio directe, utilisez le profil par défaut (aucune spécification de profil nécessaire).

Installation

Installation rapide

Cliquez sur l'un des boutons ci-dessous pour installer le serveur MCP VISO dans VS Code :

Configuration manuelle avec VS Code

Ajoutez le bloc JSON suivant à votre fichier User Settings (JSON) dans VS Code. Vous pouvez le faire en appuyant sur Ctrl + Shift + P et en tapant Preferences: Open User Settings (JSON).

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "viso_baseurl",
        "description": "VISO TRUST API Base URL",
        "default": "https://app.visotrust.com"
      },
      {
        "type": "promptString",
        "id": "viso_token",
        "description": "VISO TRUST API Token",
        "password": true
      }
    ],
    "servers": {
      "viso-mcp": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "VISOTRUST_API_TOKEN",
          "-e",
          "VISOTRUST_API_BASEURL",
          "visotrustai/viso-mcp-server:latest"
        ],
        "env": {
          "VISOTRUST_API_BASEURL": "${input:viso_baseurl}",
          "VISOTRUST_API_TOKEN": "${input:viso_token}"
        }
      }
    }
  }
}

Optionnellement, vous pouvez ajouter un exemple similaire (c'est-à-dire sans la clé mcp) à un fichier appelé .vscode/mcp.json dans votre espace de travail. Cela vous permettra de partager la configuration avec d'autres.

{
  "inputs": [
    {
      "type": "promptString",
      "id": "viso_baseurl",
      "description": "VISO TRUST API Base URL",
      "default": "https://app.visotrust.com"
    },
    {
      "type": "promptString",
      "id": "viso_token",
      "description": "VISO TRUST API Token",
      "password": true
    }
  ],
  "servers": {
    "viso-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "VISOTRUST_API_TOKEN",
        "-e",
        "VISOTRUST_API_BASEURL",
        "visotrustai/viso-mcp-server:latest"
      ],
      "env": {
        "VISOTRUST_API_BASEURL": "${input:viso_baseurl}",
        "VISOTRUST_API_TOKEN": "${input:viso_token}"
      }
    }
  }
}

Utilisation avec Claude Desktop et autres clients MCP

Configuration Docker

{
    "mcpServers": {
        "viso-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "-e", "VISOTRUST_API_TOKEN",
                "-e", "VISOTRUST_API_BASEURL",
                "visotrustai/viso-mcp-server:latest"
            ],
            "env": {
                "VISOTRUST_API_TOKEN": "<your-api-token>",
                "VISOTRUST_API_BASEURL": "https://app.visotrust.com"
            }
        }
    }
}

Configuration Java

{
    "mcpServers": {
        "viso-mcp": {
            "command": "java",
            "args": [
                "-jar",
                "viso-mcp-server-<version>.jar",
                "--port",
                "8080",
                "--host",
                "localhost"
            ],
            "env": {
                "JAVA_TOOL_OPTIONS": "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005",
                "VISOTRUST_API_TOKEN": "<your-api-token>",
                "VISOTRUST_API_BASEURL": "https://app.visotrust.com"
            }
        }
    }
}

Remarque : La variable d'environnement JAVA_TOOL_OPTIONS est utilisée pour définir les options JVM pour le débogage à distance. L'adresse et le port peuvent être modifiés selon les besoins.

💻 Développement

Configuration Docker

Construire l'image Docker

docker build -t viso-mcp-server .

Exécuter le conteneur Docker

docker run -i --rm -e VISOTRUST_API_TOKEN=<your-api-token> viso-mcp-server

Débogage

Installer MCP Inspector

npm -g install @modelcontextprotocol/inspector

Exécuter MCP Inspector pour les tests

1. Construire le fichier JAR du serveur MCP

./gradlew bootJar

2. Exécuter MCP Inspector

npx @modelcontextprotocol/inspector \
    -e JAVA_TOOL_OPTIONS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=\*:5005 \
    -e VISOTRUST_API_TOKEN=<your-api-token> \
    java -jar build/libs/viso-mcp-server-<version>.jar \
    --port 8080 --host localhost

Remplacez <version> par la version actuelle du projet (par exemple, 1.0.0 ou la version de la dernière version).

Pipeline CI/CD

Ce projet utilise GitHub Actions pour l'intégration et le déploiement continus. Le flux de travail comprend les tâches suivantes :

Lint

Vérifie le formatage du code à l'aide de Spotless :

./gradlew spotlessCheck

Build

Construit l'application et crée un fichier JAR :

./gradlew build

Publish

Lorsqu'une nouvelle version est créée :

1. Met à jour la version du projet dans build.gradle pour correspondre à l'étiquette de version
2. Télécharge le fichier JAR vers la version GitHub avec la version de l'étiquette de version
3. Construit et pousse l'image Docker vers Docker Hub avec les étiquettes :
   • latest
   • L'étiquette de version (par exemple, v1.0.0)

Secrets requis pour la publication

Pour activer la publication sur Docker Hub, ajoutez ces secrets à votre dépôt GitHub :

• DOCKERHUB_USERNAME : Votre nom d'utilisateur Docker Hub
• DOCKERHUB_TOKEN : Votre jeton d'accès Docker Hub

🛠️ Outils

Cette section fournit la documentation des outils exposés par le serveur MCP VISO. Chaque outil a un objectif spécifique, des paramètres d'entrée et un format de sortie.

Évaluations

get_assessment - Obtenir une évaluation par son ID

• id : ID de l'évaluation (nombre, obligatoire)

Renvoie des informations détaillées sur une évaluation spécifique.

get_assessment_summary - Obtenir le résumé d'une évaluation par son ID

• id : ID de l'évaluation (nombre, obligatoire)

Renvoie les détails du résumé pour une évaluation spécifique.

create_assessment - Démarrer une évaluation pour une relation existante

• relationshipId : L'ID de la relation pour laquelle créer une évaluation (nombre, obligatoire)
• recipientEmail : Adresse e-mail du destinataire de l'évaluation (chaîne, optionnel)
• recipientFirstName : Prénom du destinataire de l'évaluation (chaîne, optionnel)
• recipientLastName : Nom de famille du destinataire de l'évaluation (chaîne, optionnel)
• publicDocumentUrls : URLs des documents publics à inclure dans l'évaluation (chaîne[], optionnel)
• followupType : Type de suivi (énumération de chaînes, optionnel)
• followupRiskThreshold : Seuil de niveau de risque qui déclenche le suivi (énumération de chaînes, optionnel)
• followupTimeline : Calendrier des actions de suivi (énumération de chaînes, optionnel)
• collectionTimeline : Calendrier pour que le fournisseur termine la soumission de l'évaluation (énumération de chaînes, optionnel)
• noVendorResponseAction : Action à entreprendre lorsque le fournisseur ne répond pas (énumération de chaînes, optionnel)
• aiProcessingOnly : S'il faut traiter uniquement avec l'IA sans examen humain (booléen, optionnel)
• requestedAuditTypes : Types d'audits demandés pour cette évaluation (chaîne[], optionnel)

Renvoie les détails de l'évaluation créée.

update_assessment_expiration_date - Mettre à jour la date limite à laquelle le fournisseur doit soumettre sa réponse à l'évaluation

• id : ID de l'évaluation (nombre, obligatoire)
• expirationDate : Nouvelle date/heure d'expiration, ISO-8601 avec décalage ; doit être dans le futur (chaîne, obligatoire)

Renvoie un message de confirmation.

update_assessment_followup - Mettre à jour la configuration de suivi pour une évaluation

• id : ID de l'évaluation (nombre, obligatoire)
• followupType : Type de suivi (énumération de chaînes, obligatoire)
• followupRiskThreshold : Seuil de risque auquel ou au-dessus duquel une évaluation de suivi doit être déclenchée (énumération de chaînes, optionnel)
• followupTimeline : Calendrier de suivi (énumération de chaînes, optionnel)

Renvoie un message de confirmation.

Journaux d'audit

get_user_audit_log_events - Obtenir les événements du journal d'audit limités à l'utilisateur pour votre organisation

• start : Date/heure de début de la requête, ISO-8601 avec décalage (chaîne, obligatoire)
• end : Date/heure de fin de la requête, ISO-8601 avec décalage (chaîne, obligatoire)
• eventTypes : Ensemble optionnel de types d'événements à filtrer (par exemple, USER_LOGGED_IN) ; laisser vide pour tous (chaîne[], optionnel)

Renvoie une liste d'événements du journal d'audit utilisateur, limitée à 500 enregistrements.

get_audit_log_events - Obtenir les événements du journal d'audit filtrés (événements utilisateur, organisation, évaluation et relation)

• start : Date/heure de début de la requête, ISO-8601 avec décalage (chaîne, obligatoire)
• end : Date/heure de fin de la requête, ISO-8601 avec décalage (chaîne, obligatoire)
• eventTypes : Ensemble optionnel de types d'événements à filtrer (par exemple, ASSESSMENT_COMPLETED, RELATIONSHIP_CREATED) ; laisser vide pour tous (chaîne[], optionnel)

Renvoie des enregistrements d'événements du journal d'audit polymorphes. Chaque élément a au moins auditEventType et dateTime.

Cas d'affaires

get_all_business_cases - Obtenir tous les cas d'affaires disponibles pour votre organisation

Aucun paramètre requis.

Renvoie une liste de tous les cas d'affaires disponibles pour votre organisation.

Types de données

get_all_datatypes - Obtenir tous les types de données disponibles pour votre organisation

Aucun paramètre requis.

Renvoie une liste de tous les types de données disponibles pour votre organisation.

Annuaire des fournisseurs

search_vendor_directory - Rechercher un fournisseur dans l'annuaire des fournisseurs VISO TRUST par URL ou domaine

• urlOrDomain : L'URL ou le nom de domaine à rechercher, par exemple example.com (chaîne, obligatoire)

Renvoie les métadonnées de base du fournisseur (nom, page d'accueil, description, favicon, domaines connus).

Relations

get_all_relationships - Obtenir une liste de toutes les relations et leurs détails d'évaluation

Aucun paramètre requis.

Renvoie des informations sur les fournisseurs tiers, y compris leur statut d'évaluation, les niveaux de risque et les coordonnées.

get_relationship_by_id - Obtenir une relation spécifique et ses détails d'évaluation par ID

• id : ID de la relation (nombre, obligatoire)

Renvoie des informations détaillées sur un fournisseur tiers, y compris le statut d'évaluation, les niveaux de risque et les coordonnées.

get_relationship_assessment_history - Obtenir l'historique des évaluations pour une relation

• id : ID de la relation (nombre, obligatoire)

Renvoie une liste d'évaluations associées à la relation spécifiée.

create_relationship - Créer une nouvelle relation avec un fournisseur tiers

• name : Nom de la relation/fournisseur (chaîne, obligatoire)
• homepage : URL de la page d'accueil du fournisseur (chaîne, obligatoire)
• businessOwnerEmail : Adresse e-mail du propriétaire métier (chaîne, obligatoire)
• businessOwnerFirstName : Prénom du propriétaire métier (chaîne, optionnel)
• businessOwnerLastName : Nom de famille du propriétaire métier (chaîne, optionnel)
• description : Description de la relation/fournisseur (chaîne, optionnel)
• contextTypes : Liste des types de contexte métier pour cette relation (objet[], optionnel)
• dataTypes : Liste des types de données gérés dans cette relation (objet[], optionnel)
• tags : Liste d'étiquettes pour catégoriser cette relation (chaîne[], optionnel)
• thirdPartyContact : Coordonnées du représentant du fournisseur tiers (objet, optionnel)

Renvoie les détails de la relation créée.

create_relationship_by_domain - Créer une nouvelle relation en utilisant uniquement le domaine du fournisseur

• domain : Domaine du fournisseur, par exemple visotrust.com (chaîne, obligatoire)
• vendorName : Nom du fournisseur (chaîne, obligatoire)
• product : Produit offert par le fournisseur (chaîne, optionnel)
• description : Description de la relation fournisseur (chaîne, optionnel)

Renvoie les détails de la relation créée.

update_relationship - Mettre à jour une relation existante avec un fournisseur tiers

• id : ID de la relation (nombre, requis)
• name : Nom de la relation/du fournisseur (chaîne, requis)
• homepage : URL de la page d'accueil du fournisseur (chaîne, facultatif)
• description : Description de la relation/du fournisseur (chaîne, facultatif)
• contextTypes : Liste des types de contexte métier (objet[], facultatif)
• dataTypes : Liste des types de données gérés dans cette relation (objet[], facultatif)
• businessOwnerEmail : Adresse e-mail du responsable métier (chaîne, facultatif)
• businessOwnerFirstName : Prénom du responsable métier (chaîne, facultatif)
• businessOwnerLastName : Nom du responsable métier (chaîne, facultatif)
• tags : Liste des étiquettes (chaîne[], facultatif)

Renvoie les détails de la relation mise à jour.

partially_update_relationship - Mettre à jour partiellement une relation existante

Accepte les mêmes champs que update_relationship. Seuls les champs fournis dans la requête sont modifiés ; les autres champs restent inchangés.

Renvoie les détails de la relation mise à jour.

search_relationships - Rechercher des relations par nom de domaine ou nom de fournisseur

• domains : Liste des noms de domaine à rechercher (chaîne[], requis)
• name : Nom du fournisseur/de la relation à rechercher (chaîne, requis)

Renvoie une liste des relations correspondantes avec leurs détails d'évaluation.

create_tags - Créer de nouvelles étiquettes pour catégoriser les relations

• tags : Liste des noms d'étiquettes à créer (chaîne[], requis)

Renvoie une liste de toutes les étiquettes, y compris celles nouvellement créées.

update_third_party_contact - Mettre à jour les coordonnées d'un fournisseur tiers

• relationshipId : ID de la relation (nombre, requis)
• email : E-mail de contact (chaîne, requis)
• firstName : Prénom du contact (chaîne, requis)
• lastName : Nom du contact (chaîne, requis)

Renvoie les détails de la relation mise à jour.

onboard_relationship - Intégrer une relation, avec éventuellement un résumé d'approbation et des paramètres de gestion du cycle de vie

• id : ID de la relation (nombre, requis)
• approvalSummary : Résumé d'approbation facultatif enregistré lors de l'intégration (chaîne, facultatif)
• lifecycleManagementUpdateRequest : Paramètres facultatifs de gestion du cycle de vie (objet, facultatif)
  • artifactUpdateSettings.artifactUpdateType : Type de mise à jour de l'artefact (énumération de chaîne)
  • recertificationSettings.recertificationType : Type de recertification (énumération de chaîne)
  • recertificationSettings.recertificationDate : Date/heure de la prochaine recertification, ISO-8601 avec décalage (chaîne)
  • recertificationSettings.reviewFrequency : THREE_YEARS, TWO_YEARS, ANNUAL, SEMIANNUAL ou QUARTERLY (énumération de chaîne)

Renvoie les détails de la relation intégrée.

offboard_relationship - Désintégrer une relation

• id : ID de la relation (nombre, requis)

Renvoie les détails de la relation désintégrée.

archive_relationship - Archiver une relation

• id : ID de la relation (nombre, requis)

Renvoie les détails de la relation archivée.

Webhooks

get_all_webhooks - Obtenir tous les webhooks

Aucun paramètre requis.

Renvoie une liste de toutes les configurations de webhook.

get_webhook - Obtenir une configuration de webhook par ID

• id : ID du webhook (nombre, requis)

Renvoie les détails d'une configuration de webhook spécifique.

create_webhook_configuration - Créer une configuration de webhook

• request : Paramètres de création du webhook (objet, requis)
  • url : URL du webhook (chaîne, requis)
  • secret : Secret du webhook (chaîne, requis)
  • eventTypes : Types d'événements pour déclencher le webhook (chaîne[], requis)
  • serviceType : Type de service pour le webhook (chaîne, requis)

Renvoie la configuration de webhook créée.

update_webhook_configuration - Mettre à jour une configuration de webhook

• request : Paramètres de mise à jour du webhook (objet, requis)
  • id : ID du webhook (nombre, requis)
  • url : URL du webhook (chaîne, facultatif)
  • secret : Secret du webhook (chaîne, facultatif)
  • eventTypes : Types d'événements pour déclencher le webhook (chaîne[], facultatif)
  • serviceType : Type de service pour le webhook (chaîne, facultatif)

Renvoie la configuration de webhook mise à jour.

delete_webhook_configuration - Supprimer une configuration de webhook

• id : ID du webhook (nombre, requis)

Supprime la configuration de webhook spécifiée.

Rapports de renseignements

create_bitsight_intelligence_report - Créer un nouveau rapport de renseignements BitSight

• request : Paramètres du rapport BitSight (objet, requis)
  • vendorDomain : Le nom de domaine principal du fournisseur (chaîne, requis)
  • reportDate : La date/heure à laquelle le rapport a été généré (chaîne ISO 8601, requis)
  • link : Lien facultatif vers l'interface utilisateur du fournisseur (chaîne, facultatif)
  • guid : GUID BitSight pour l'entité (chaîne, requis)
  • customId : Identifiant personnalisé de BitSight (chaîne, facultatif)
  • name : Nom d'affichage de l'entité BitSight (chaîne, facultatif)
  • description : Description de l'entité BitSight (chaîne, facultatif)
  • primaryDomain : Domaine principal de l'entité BitSight (chaîne, facultatif)
  • ratingRange : Plage de notation BitSight (chaîne, facultatif)
  • ratingColor : Couleur de la notation BitSight (chaîne, facultatif)
  • confidence : Niveau de confiance de la notation BitSight (chaîne, facultatif)

Renvoie le rapport de renseignements créé.

create_security_scorecard_intelligence_report - Créer un nouveau rapport de renseignements SecurityScorecard

• request : Paramètres du rapport SecurityScorecard (objet, requis)
  • vendorDomain : Le nom de domaine principal du fournisseur (chaîne, requis)
  • reportDate : La date/heure à laquelle le rapport a été généré (chaîne ISO 8601, requis)
  • link : Lien facultatif vers l'interface utilisateur du fournisseur (chaîne, facultatif)
  • grade : Note alphabétique SecurityScorecard (chaîne, requis)
  • domain : Domaine associé à l'entité du scorecard (chaîne, facultatif)
  • score : Score numérique de SecurityScorecard (nombre, facultatif)

Renvoie le rapport de renseignements créé.

create_recorded_future_intelligence_report - Créer un nouveau rapport de renseignements Recorded Future

• request : Paramètres du rapport Recorded Future (objet, requis)
  • vendorDomain : Le nom de domaine principal du fournisseur (chaîne, requis)
  • reportDate : La date/heure à laquelle le rapport a été généré (chaîne ISO 8601, requis)
  • entityType : Type d'entité Recorded Future, par exemple Company (chaîne, requis)
  • entity : Identifiant d'entité Recorded Future (chaîne, requis)
  • riskScore : Score de risque numérique (nombre, requis)
  • riskLevel : Libellé du niveau de risque, par exemple Critical/High/Medium/Low (chaîne, requis)
  • link : Lien facultatif vers le rapport dans l'interface utilisateur du fournisseur (chaîne, facultatif)
  • firstSeen : Date d'observation la plus ancienne pour l'entité, ISO 8601 (chaîne, facultatif)
  • lastSeen : Date d'observation la plus récente pour l'entité, ISO 8601 (chaîne, facultatif)
  • triggeredRuleCount : Nombre de règles Recorded Future qui se sont déclenchées (nombre, facultatif)
  • maxRuleCount : Nombre maximum de règles Recorded Future évaluées (nombre, facultatif)
  • summary : Texte de résumé facultatif de Recorded Future (chaîne, facultatif)
  • criticalityLabel : Libellé de criticité Recorded Future pour l'entité (chaîne, facultatif)

Renvoie le rapport de renseignements créé.

get_intelligence_reports_by_vendor - Obtenir tous les rapports de renseignements pour un fournisseur

• vendorDomain : Le nom de domaine principal du fournisseur (chaîne, requis)

Renvoie une liste des rapports de renseignements pour le fournisseur spécifié.

get_latest_intelligence_report - Obtenir le dernier rapport de renseignements pour un fournisseur d'une source spécifique

• vendorDomain : Le nom de domaine principal du fournisseur (chaîne, requis)
• source : Fournisseur de renseignements (énumération de chaîne : BITSIGHT, SECURITY_SCORECARD ou RECORDED_FUTURE, requis)

Renvoie le dernier rapport de renseignements pour le fournisseur et la source spécifiés.

Utilisateurs

get_all_users - Obtenir tous les utilisateurs de votre organisation

• page : Page de résultats à récupérer (nombre, facultatif ; par défaut 0)
• size : Nombre d'enregistrements par page (nombre, facultatif ; par défaut 20)
• sort : Critères de tri au format : propriété(,asc|desc) (chaîne, facultatif)

Renvoie une liste paginée d'utilisateurs.

get_user_by_email - Obtenir un utilisateur par e-mail

• email : Adresse e-mail de l'utilisateur (chaîne, requis)

Renvoie les détails de l'utilisateur.

create_user - Créer un nouvel utilisateur

• request : Paramètres de création de l'utilisateur (objet, requis)
  • email : Adresse e-mail du nouvel utilisateur (chaîne, requis)
  • firstName : Prénom du nouvel utilisateur (chaîne, requis)
  • lastName : Nom du nouvel utilisateur (chaîne, requis)

Renvoie l'utilisateur créé.

Formatage du code

Ce projet utilise Spotless avec Google Java Format pour le formatage du code. Un hook de pré-commit est automatiquement mis en place pour garantir un style de code cohérent.

Configuration

Après avoir cloné le dépôt, le hook de pré-commit sera automatiquement configuré lorsque vous exécuterez une commande Gradle.

Formatage manuel

Pour formater manuellement tous les fichiers :

./gradlew spotlessApply

Pour vérifier si les fichiers sont correctement formatés :

./gradlew spotlessCheck

Si le hook de pré-commit rejette votre commit en raison de problèmes de formatage, exécutez simplement ./gradlew spotlessApply pour corriger le formatage, puis réessayez de valider.

Licence

Ce projet est sous licence MIT - voir le fichier LICENSE pour plus de détails.