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 termine l’achat.
2. Dodo Payments crée une subvention avec le statut pending avec un oauth_url pour que le client puisse lier son compte GitHub.
3. Le client autorise via le lien dans son e-mail ou portail client.
4. Dodo Payments invite le compte GitHub du client au dépôt avec la permission configurée. La subvention passe à delivered une fois l’invitation créée.
5. Si l’abonnement est annulé, remboursé ou révoqué, le collaborateur est retiré.

​

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 inclut le oauth_url pour l’autorisation GitHub.
• entitlement_grant.delivered est déclenché une fois l’invitation du collaborateur créée.
• entitlement_grant.failed est déclenché avec error_code: "github_permission_denied" (ou similaire) si l’application GitHub a perdu l’accès au dépôt.

​

Dépannage