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 Checkout ab.
2. Dodo Payments erstellt einen Grant im Status Pending. Sein oauth_url ist null, bis der Kunde den Akzeptierungsablauf startet. Zu diesem Zeitpunkt wird es mit einer GitHub-Autorisierungs-URL befüllt.
3. Der Kunde autorisiert den Zugriff über den Link in seiner E-Mail oder im Customer Portal.
4. Dodo Payments lädt das GitHub-Konto des Kunden mit der konfigurierten Berechtigung in das Repository ein. Der Grant wechselt zu Delivered, sobald die Einladung erstellt wurde.
5. Wenn das Abonnement gekündigt, erstattet oder widerrufen wird, wird der Kunde als Mitwirkender 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 wird mit status: "Pending" ausgelöst, während oauth_url noch null ist. Die GitHub-Autorisierungs-URL wird ausgefüllt, sobald der Kunde den Akzeptierungsablauf über seine Zustellungs-E-Mail oder das Customer Portal startet.
• entitlement_grant.delivered wird ausgelöst, sobald die Einladung des Mitwirkenden erstellt wurde.
• entitlement_grant.failed wird mit error_code: "github_permission_denied" (oder einem ähnlichen Wert) ausgelöst, wenn die GitHub App den Zugriff auf das Repository verloren hat.

​

Fehlerbehebung