Skip to content

Commit

Permalink
chore: md linting
Browse files Browse the repository at this point in the history
  • Loading branch information
tnramalho committed Sep 30, 2024
1 parent d4b6d7d commit 0df283a
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 15 deletions.
6 changes: 4 additions & 2 deletions packages/nestjs-auth-github/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,8 +44,10 @@ official documentation](https://docs.github.com/en/apps/oauth-apps/building-oaut

## Getting Started with GitHub Authentication

**Prerequisite:** Github module has a dependency on `@concepta/nestjs-federated`. Ensure you have implemented the `FederatedModule` before proceeding. Refer to
the [Federated API Documentation](https://www.rockets.tools/reference/rockets/nestjs-federated/README) for more details.
**Prerequisite:** Github module has a dependency on
`@concepta/nestjs-federated`. Ensure you have implemented the `FederatedModule`
before proceeding. Refer to the [Federated API Documentation](https://www.rockets.tools/reference/rockets/nestjs-federated/README)
for more details.

### Step 1: Associate User Entity to Federated Entity

Expand Down
41 changes: 28 additions & 13 deletions packages/nestjs-federated/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@ Authenticate via federated login

# Table of Contents

Check notice on line 13 in packages/nestjs-federated/README.md

View check run for this annotation

Codacy Production / Codacy Static Code Analysis

packages/nestjs-federated/README.md#L13

Multiple top-level headings in the same document


1. [Tutorials](#tutorials)
- [Introduction](#introduction)
- [Getting Started with Federated Authentication](#getting-started-with-federated-authentication)
Expand All @@ -36,10 +35,13 @@ Authenticate via federated login
## Introduction

Before we begin, you'll need to set up OAuth Apps for the social providers you
wish to use (e.g., GitHub, Google, Facebook) to obtain the necessary
credentials. For detailed guides on creating OAuth Apps and obtaining your
Client IDs and Client Secrets, please refer to the official documentation of
each provider and refer to the (`@concepta/nestjs-auth-github`)[https://www.rockets.tools/reference/rockets/nestjs-auth-github/README] , (`nestjs-auth-apple`)[https://www.rockets.tools/reference/rockets/nestjs-auth-apple/README] and (`@concepta/nestjs-auth-google`)[https://www.rockets.tools/reference/rockets/nestjs-auth-google/README] documentation to use our modules.
wish to use (e.g., GitHub, Google, Facebook) to obtain the necessary credentials.
For detailed guides on creating OAuth Apps and obtaining your Client IDs and
Client Secrets, please refer to the official documentation of each provider and
refer to the [`@concepta/nestjs-auth-github`](https://www.rockets.tools/reference/rockets/nestjs-auth-github/README),
[`nestjs-auth-apple`](https://www.rockets.tools/reference/rockets/nestjs-auth-apple/README),
and [`@concepta/nestjs-auth-google`](https://www.rockets.tools/reference/rockets/nestjs-auth-google/README)
documentation to use our modules.

## Getting Started with Federated Authentication

Expand Down Expand Up @@ -81,10 +83,14 @@ export class FederatedEntity extends FederatedSqliteEntity {
```

### Step 3: Implement FederatedUserLookupServiceInterface
Refer to [Implement FederatedUserLookupServiceInterface](#implement-federateduserlookupserviceinterface) section

Refer to [Implement FederatedUserLookupServiceInterface](#implement-federateduserlookupserviceinterface)
section

### Step 4: Implement FederatedUserMutateServiceInterface
Refer to [Implement FederatedUserMutateServiceInterface](#implement-federatedusermutateserviceinterface) section

Refer to [Implement FederatedUserMutateServiceInterface](#implement-federatedusermutateserviceinterface)
section

### Step 5: Configure the Module

Expand Down Expand Up @@ -132,28 +138,37 @@ export class AppModule {}
```

This configuration uses SQLite for testing, but you can use any database
supported by TypeORM.
supported by TypeORM.

### Step 6: Integrate with other Oauth Module

To complete the integration with OAuth providers and set up the whole authentication flow, you'll need to implement one of the @concepta social authentication modules. Follow the documentation for the specific module you want to use:
To complete the integration with OAuth providers and set up the whole
authentication flow, you'll need to implement one of the @concepta social
authentication modules. Follow the documentation for the specific module you
want to use:

1. GitHub Authentication:
Refer to the [@concepta/nestjs-auth-github documentation](https://www.rockets.tools/reference/rockets/nestjs-auth-github/README) for detailed instructions on setting up GitHub OAuth authentication.
Refer to the [@concepta/nestjs-auth-github documentation](https://www.rockets.tools/reference/rockets/nestjs-auth-github/README)
for detailed instructions on setting up GitHub OAuth authentication.

2. Apple Authentication:
For Apple Sign-In, follow the [nestjs-auth-apple documentation](https://www.rockets.tools/reference/rockets/nestjs-auth-apple/README) to implement Apple's OAuth flow.
For Apple Sign-In, follow the [nestjs-auth-apple documentation](https://www.rockets.tools/reference/rockets/nestjs-auth-apple/README)
to implement Apple's OAuth flow.

3. Google Authentication:
To set up Google OAuth, consult the [@concepta/nestjs-auth-google documentation](https://www.rockets.tools/reference/rockets/nestjs-auth-google/README) for step-by-step guidance.
To set up Google OAuth, consult the [@concepta/nestjs-auth-google documentation](https://www.rockets.tools/reference/rockets/nestjs-auth-google/README)
for step-by-step guidance.

These documentation resources will guide you through:

- Obtaining the necessary OAuth credentials from the respective providers
- Configuring the OAuth module in your NestJS application
- Setting up the required controllers and routes
- Implementing the authentication flow

By following these provider-specific guides, you'll be able to complete the federated authentication setup and enable users to log in using their preferred social accounts.
By following these provider-specific guides, you'll be able to complete the
federated authentication setup and enable users to log in using their preferred
social accounts.

## How-To Guides

Expand Down

0 comments on commit 0df283a

Please sign in to comment.