GitHub-rättighet

​

Vad som levereras

• Kunden blir inbjuden till ditt GitHub-repository genom ett OAuth-flöde som länkar deras GitHub-konto till köpet.
• När de accepterar, ger GitHub dem samarbetaråtkomst på den konfigurerade behörighetsnivån.
• Avbokning, återbetalning eller manuell ångerrätt tar bort samarbetaren.

​

Anslut GitHub

1

Open Entitlements

Gå till Rättigheter i din Dodo Payments-instrumentpanel och klicka på + för att starta en ny rättighet.

2

Pick GitHub

Välj GitHub Access som integration. Om GitHub inte är anslutet ännu, kommer du att uppmanas att Anslut GitHub.

När du klickar öppnas GitHub i en ny flik. Logga in och installera Dodo Payments GitHub App på organisationens eller användarkontot som äger repositoty. Du kan ge åtkomst till alla repositories eller bara de du avser att låsa.

När GitHub omdirigeras tillbaka, ser du en bekräftelse på att kontot är anslutet.

3

Pick a repository and permission

Tillbaka i instrumentpanelen, välj repositoryn som rättigheten ska ge åtkomst till och välj behörighetsnivån. Repositoryväljaren visar endast repositories som GitHub-appen har åtkomst till. Ge rättigheten ett namn och klicka på Skapa Rättighet.

4

Save the entitlement

Spara och bifoga rättigheten till vilken produkt som helst. Kunder som köper den produkten får en GitHub-inbjudan vid leverans.

​

Behörighetsnivåer

​

Kundflöde

1. Kunden slutför checkout.
2. Dodo Payments skapar en grant med statusen Pending. Dess oauth_url är null tills kunden påbörjar accept-flödet, då den fylls i med en GitHub-auktoriserings-URL.
3. Kunden auktoriserar via länken i sitt e-postmeddelande eller i Customer Portal.
4. Dodo Payments bjuder in kundens GitHub-konto till repositoryt med den konfigurerade behörigheten. Grantens status ändras till Delivered när inbjudan har skapats.
5. Om prenumerationen avslutas, återbetalas eller återkallas tas kunden bort som collaborator.

​

Obligatorisk konfiguration

​

Skapa via 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 utlöses med status: "Pending" och oauth_url fortfarande null; GitHub-auktoriserings-URL:en fylls i när kunden påbörjar accept-flödet från sitt leveransmejl eller Customer Portal.
• entitlement_grant.delivered utlöses när collaborator-inbjudan har skapats.
• entitlement_grant.failed utlöses med error_code: "github_permission_denied" (eller liknande) om GitHub App förlorar åtkomsten till repositoryt.

​

Felsökning