Droit GitHub

​

Ce qui est livré

• Le client est invité à votre dépôt GitHub via un flux OAuth qui lie leur compte GitHub à l’achat.
• Une fois qu’ils acceptent, GitHub leur accorde l’accès collaborateur au niveau de permission configuré.
• L’annulation, le remboursement ou la révocation manuelle supprime le collaborateur.

​

Connecter GitHub

1

Open Entitlements

Dans votre tableau de bord Dodo Payments, allez à Droits et cliquez sur + pour commencer un nouveau droit.

2

Pick GitHub

Choisissez Accès GitHub comme intégration. Si GitHub n’est pas encore connecté, il vous sera demandé de Connecter GitHub.

En cliquant dessus, GitHub s’ouvre dans un nouvel onglet. Connectez-vous, puis installez l’application GitHub Dodo Payments sur l’organisation ou le compte utilisateur qui possède le dépôt. Vous pouvez accorder l’accès à tous les dépôts ou seulement à ceux que vous souhaitez protéger.

Lorsque GitHub redirige en retour, vous verrez une confirmation que le compte est connecté.

3

Pick a repository and permission

De retour dans le tableau de bord, choisissez le dépôt auquel le droit doit accorder l’accès et sélectionnez le niveau de permission. Le sélecteur de dépôt n’affiche que les dépôts auxquels l’application GitHub a accès. Donnez un nom au droit et cliquez sur Créer un droit.

4

Save the entitlement

Enregistrez et attachez le droit à tout produit. Les clients qui achètent ce produit reçoivent une invitation GitHub lors de la livraison.

​

Niveaux de permission

​

Flux client

1. Le client finalise le processus de paiement.
2. Dodo Payments crée une autorisation avec le statut Pending. Sa valeur oauth_url est null jusqu’à ce que le client commence le processus d’acceptation, auquel moment elle est renseignée avec une URL d’autorisation GitHub.
3. Le client s’autorise via le lien présent dans son e-mail ou dans le Customer Portal.
4. Dodo Payments invite le compte GitHub du client à rejoindre le dépôt avec le niveau d’autorisation configuré. L’autorisation passe à Delivered une fois l’invitation créée.
5. Si l’abonnement est annulé, remboursé ou révoqué, le client est supprimé en tant que collaborateur.

​

Configuration requise

​

Créer via l’API

const entitlement = await client.entitlements.create({
  name: 'Code Share Repository',
  integration_type: 'github',
  integration_config: {
    target_id: 'acme/private-sdk',
    permission: 'pull',
  },
});

client.entitlements.create(
    name="Code Share Repository",
    integration_type="github",
    integration_config={
        "target_id": "acme/private-sdk",
        "permission": "pull",
    },
)

client.Entitlements.New(ctx, dodopayments.EntitlementNewParams{
  Name:            dodopayments.F("Code Share Repository"),
  IntegrationType: dodopayments.F(dodopayments.EntitlementIntegrationTypeGithub),
  IntegrationConfig: dodopayments.F[dodopayments.IntegrationConfigUnionParam](
    dodopayments.IntegrationConfigGitHubConfigParam{
      TargetID:   dodopayments.F("acme/private-sdk"),
      Permission: dodopayments.F("pull"),
    },
  ),
})

​

Webhooks

• entitlement_grant.created se déclenche avec status: "Pending" et oauth_url toujours défini sur null ; l’URL d’autorisation GitHub est renseignée lorsque le client commence le processus d’acceptation depuis son e-mail de livraison ou le Customer Portal.
• entitlement_grant.delivered se déclenche une fois l’invitation du collaborateur créée.
• entitlement_grant.failed se déclenche avec error_code: "github_permission_denied" (ou une valeur similaire) si la GitHub App a perdu l’accès au dépôt.

​

Dépannage