GitHub Berechtigung

​

Was geliefert wird

• Der Kunde wird über einen OAuth-Flow, der seinen GitHub-Account mit dem Kauf verknüpft, zu Ihrem GitHub-Repository eingeladen.
• Sobald sie akzeptieren, gewährt GitHub ihnen auf der konfigurierten Berechtigungsebene Kollaboratorenzugang.
• Kündigung, Rückerstattung oder manueller Widerruf entfernt den Kollaborator.

​

GitHub verbinden

1

Open Entitlements

Gehen Sie in Ihrem Dodo Payments-Dashboard zu Berechtigungen und klicken Sie auf + , um eine neue Berechtigung zu starten.

2

Pick GitHub

Wählen Sie GitHub-Zugang als Integration. Falls GitHub noch nicht verbunden ist, werden Sie aufgefordert, GitHub verbinden auszuwählen.

Durch Klicken öffnet sich GitHub in einem neuen Tab. Melden Sie sich an und installieren Sie die Dodo Payments GitHub App im Organisations- oder Benutzerkonto, das das Repository besitzt. Sie können Zugriff auf alle Repositories oder nur auf die gewähren, die Sie sperren möchten.

Wenn GitHub zurückleitet, sehen Sie eine Bestätigung, dass das Konto verbunden ist.

3

Pick a repository and permission

Zurück im Dashboard, wählen Sie das Repository, dem die Berechtigung Zugriff gewähren soll, und wählen Sie die Berechtigungsstufe. Der Repository-Auswahldialog zeigt nur Repositories an, auf die die GitHub App Zugriff hat. Geben Sie der Berechtigung einen Namen und klicken Sie auf Berechtigung erstellen.

4

Save the entitlement

Speichern und die Berechtigung einem Produkt zuweisen. Kunden, die dieses Produkt kaufen, erhalten bei Lieferung eine GitHub-Einladung.

​

Berechtigungsstufen

​

Kundenfluss

1. Der Kunde schließt den Kauf ab.
2. Dodo Payments erstellt einen Grant im pending-Status mit einem oauth_url, damit der Kunde seinen GitHub-Account verknüpfen kann.
3. Der Kunde autorisiert über den Link in seiner E-Mail oder im Kundenportal.
4. Dodo Payments lädt den GitHub-Account des Kunden mit der konfigurierten Berechtigung zum Repository ein. Der Grant wechselt zu delivered, sobald die Einladung erstellt ist.
5. Wenn das Abonnement gekündigt, erstattet oder widerrufen wird, wird der Kunde als Kollaborator entfernt.

​

Erforderliche Konfiguration

​

Erstellung über 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 enthält den oauth_url für die GitHub-Autorisierung.
• entitlement_grant.delivered wird ausgelöst, sobald die Kollaborator-Einladung erstellt ist.
• entitlement_grant.failed wird mit error_code: "github_permission_denied" (oder ähnlich) ausgelöst, wenn die GitHub App den Zugriff auf das Repository verloren hat.

​

Fehlerbehebung