Skip to content
Skills Library
Programming · Tool integration

orchardcore-github-authentication

/orchardcore-github-authentication

Skill for configuring GitHub OAuth authentication in Orchard Core. Covers GitHub external login settings, OAuth callback paths, the GitHubAuthenticationSettings recipe step with ConsumerKey and ConsumerSecret, the generic Settings step, ConfigureGitHubSettings with the OrchardCore Authentication GitHub configuration section, ExternalAuthentication dependencies, and user registration behavior. Use this skill when requests mention Orchard Core GitHub Authentication, GitHub OAuth, sign in with GitHub, GitHubAuthenticationSettings, ConfigureGitHubSettings, GitHub callback URL, or closely related O

Licence
MIT
Last repository change
21.10.2026

Assessment and security

95/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content30 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 21.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Skill for configuring GitHub OAuth authentication in Orchard Core. Covers GitHub external login settings, OAuth callback paths, the GitHubAuthenticationSettings recipe step with ConsumerKey and ConsumerSecret, the generic Settings step, ConfigureGitHubSettings with the OrchardCore Authentication GitHub configuration section, ExternalAuthentication dependencies, and user registration behavior. Use this skill when requests mention Orchard Core GitHub Authentication, GitHub OAuth, sign in with GitHub, GitHubAuthenticationSettings, ConfigureGitHubSettings, GitHub callback URL, or closely related O

Original author description

Skill for configuring GitHub OAuth authentication in Orchard Core. Covers GitHub external login settings, OAuth callback paths, the GitHubAuthenticationSettings recipe step with ConsumerKey and ConsumerSecret, the generic Settings step, ConfigureGitHubSettings with the OrchardCore Authentication GitHub configuration section, ExternalAuthentication dependencies, and user registration behavior. Use this skill when requests mention Orchard Core GitHub Authentication, GitHub OAuth, sign in with GitHub, GitHubAuthenticationSettings, ConfigureGitHubSettings, GitHub callback URL, or closely related O

How it works

  1. Recipe Steps
  2. Configuration Overrides
  3. Upgrading from 3.x
Original SKILL.md headings · 101 lines, 321 words
SKILL.md preview
---
name: orchardcore-github-authentication
description: Skill for configuring GitHub OAuth authentication in Orchard Core. Covers GitHub external login settings, OAuth callback paths, the GitHubAuthenticationSettings recipe step with ConsumerKey and ConsumerSecret, the generic Settings step, ConfigureGitHubSettings with the OrchardCore Authentication GitHub configuration section, ExternalAuthentication dependencies, and user registration behavior. Use this skill when requests mention Orchard Core GitHub Authentication, GitHub OAuth, sign in with GitHub, GitHubAuthenticationSettings, ConfigureGitHubSettings, GitHub callback URL, or closely related Orchard Core implementation setup extension upgrade or troubleshooting work.
license: Apache-2.0
metadata:
  author: CrestApps Team
  version: "1.0"
---

# Orchard Core GitHub Authentication

Enable `OrchardCore.GitHub.Authentication`; it depends on
`OrchardCore.Users.ExternalAuthentication`. Configure it at
**Settings → Security → Authentication → GitHub**.

The persisted `GitHubAuthenticationSettings` properties are `ClientID`,
`ClientSecret`, `CallbackPath`, and `SaveTokens`. The default callback path is
`/signin-github`. Register the tenant's full HTTPS callback URL as the
Authorization callback URL of the GitHub OAuth App.

The integration uses the `AspNet.Security.OAuth.GitHub` package
(`GitHubAuthenticationDefaults`, `GitHubAuthenticationOptions`,
`GitHubAuthenticationHandler`). The old `GithubDefault`, `GithubOptions`,
`GithubHandler`, and `IGithubAuthenticationService` APIs were removed in 3.0.

## Recipe Steps

The dedicated `GitHubAuthenticationSettings` recipe step deliberately uses
`ConsumerKey` and `ConsumerSecret`, which the handler maps to the persisted
client ID and secret:

```json
{
  "steps": [
    {
      "name": "Feature",
      "enable": [
        "OrchardCore.GitHub.Authentication"
      ]
    },
    {
      "name": "GitHubAuthenticationSettings",
      "ConsumerKey": "github-oauth-client-id",
      "CallbackPath": "/signin-github"
    }
  ]
}
```

The generic `Settings` step accepts the persisted shape, including
`SaveTokens`:

```json
{
  "steps": [
    {
      "name": "Settings",
      "GitHubAuthenticationSettings": {
        "ClientID": "github-oauth-client-id",
        "CallbackPath": "/signin-github",
        "SaveTokens": false
      }
    }
  ]
}
```

The handler decrypts the stored client secret with data protection, as saved
from the admin page. A secret imported by a recipe is stored as is and fails
to decrypt, so enter the secret on the admin page. Both steps replace the
stored values, so re-running them clears a secret entered earlier.

## Configuration Overrides

```csharp
builder.Services
    .AddOrchardCms()
    .ConfigureGitHubSettings();
```

```json
{
  "OrchardCore": {
    "Authentication": {
      "GitHub": {
        "ClientID": "github-oauth-client-id",
        "ClientSecret": "",
        "CallbackPath": "/signin-github",
        "SaveTokens": false
      }
    }
  }
}
```

Unlike the Facebook, Google, Microsoft Account, and X secrets, the GitHub
`ClientSecret` is not listed among the secrets that 4.0 accepts as plain
values from configuration; verify the behavior before relying on it and keep
client secrets out of committed configuration.

Enable `OrchardCore.Users.Registration` only when external visitors may create
local accounts; new external users are governed by
`ExternalRegistrationSettings` (see `orchardcore-users-roles`). Authentication
does not grant Orchard roles or permissions.

## Upgrading from 3.x

- Rename the `OrchardCore_GitHub` configuration section to `OrchardCore:Authentication:GitHub` (the old name still works but is deprecated).

Versions

The database has no other skills named orchardcore-github-authentication.

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version 2b65769d5967 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 95orchardcore-microsoft-auth
    Skill for configuring Microsoft authentication in Orchard Core. Covers Microsoft Account login, Microsoft Entra ID (Azure AD) authentication, single and multi-tenant app registrations, current feature IDs, current settings paths, MicrosoftAccountSettings and AzureADSettings…
  • 100orchardcore-twitter
    Skill for integrating X Twitter in Orchard Core. Covers TwitterClient, X API settings, sign in with X Twitter, TwitterSettings, TwitterSigninSettings, ConfigureTwitterSettings with the OrchardCore X configuration section, ConsumerSecret and AccessTokenSecret from configuration…
  • 100orchardcore-recipe-creator
    Creates OrchardCore setup recipes (.recipe.json) that provision a tenant on setup — enabling features, setting themes, defining content types, importing content, roles, and settings. Use when the user needs to create a setup recipe, a starter recipe, or automate tenant configuration.
  • 100oauth-callback-handler
    Manage oauth callback handler operations. Auto-activating skill for API Integration. Triggers on: oauth callback handler, oauth callback handler Part of the API Integration skill category. Use when working with oauth callback handler functionality. Trigger with phrases like…
  • 100socialite-development
    Manages OAuth social authentication with Laravel Socialite. Activate when adding social login providers; configuring OAuth redirect/callback flows; retrieving authenticated user details; customizing scopes or parameters; setting up community providers; testing with Socialite…
  • 100clerk-core-workflow-a
    Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.