Configuration

MCM.ApiProxy utilise le système de configuration standard de .NET. Vous devez configurer l'URL de base et votre clé API.

Configuration de base

1. Ajouter la configuration

Ajoutez la section McmApi dans votre fichier de configuration :

appsettings.json

{
  "McmApi": {
    "BaseUrl": "https://api.macartedemembre.com",
    "ApiKey": "votre-cle-api"
  }
}

Sécurité

Ne versionnez jamais votre clé API dans le code source. Utilisez les secrets utilisateur en développement et les variables d'environnement ou un coffre de secrets en production.

2. Enregistrer les services

Dans votre Program.cs ou Startup.cs, ajoutez l'appel à AddMcmApiClient :

Program.cs

using MCM.ApiProxy;

var builder = WebApplication.CreateBuilder(args);

// Ajouter les clients MCM
builder.Services.AddMcmApiClient(builder.Configuration);

// ... autres services
var app = builder.Build();

Configuration avancée

Utiliser les secrets utilisateur (développement)

Pour le développement local, utilisez les secrets utilisateur pour ne pas exposer votre clé API :

# Initialiser les secrets (une seule fois)
dotnet user-secrets init

# Ajouter la clé API
dotnet user-secrets set "McmApi:ApiKey" "votre-cle-api"

Variables d'environnement (production)

En production, utilisez les variables d'environnement :

# Linux/macOS
export McmApi__BaseUrl="https://api.macartedemembre.com"
export McmApi__ApiKey="votre-cle-api"

# Windows PowerShell
$env:McmApi__BaseUrl = "https://api.macartedemembre.com"
$env:McmApi__ApiKey = "votre-cle-api"

Notation avec double underscore

.NET utilise __ (double underscore) pour représenter la hiérarchie dans les variables d'environnement.

Azure Key Vault

Pour une sécurité optimale en production, utilisez Azure Key Vault :

Program.cs

var builder = WebApplication.CreateBuilder(args);

// Ajouter Azure Key Vault
builder.Configuration.AddAzureKeyVault(
    new Uri("https://votre-keyvault.vault.azure.net/"),
    new DefaultAzureCredential());

builder.Services.AddMcmApiClient(builder.Configuration);

Options de configuration

Propriété	Type	Description	Requis
BaseUrl	string	URL de base de l'API MCM	Oui
ApiKey	string	Clé d'authentification API	Oui

Environnements

Environnement	URL
Production	https://api.macartedemembre.com
Staging	https://api-staging.macartedemembre.com
Développement	Demander à l'équipe MCM

Prochaine étape

Commencez à utiliser les clients MCM :

➡️ Démarrage rapide