Skip to content

Register an application in Asgardeo
2 min

First, unless you already have done that, you need to create an organization in Asgardeo and register Teamspace app.

  1. Sign up for a free Asgardeo account
  2. Sign into Asgardeo console and navigate to Applications > New Application.

  3. Select Traditional Web Application

    Select Traditional Page Application

  4. Select OpenID Connect (OIDC) as the protocol and provide a suitable name and an authorized redirect URL

    Example

    Name: Teamspace

    Authorized redirect URL: http://localhost:3000/api/auth/callback/asgardeo

    Register a new application

    Info

    The authorized redirect URL determines where Asgardeo should send users after they successfully log in. Typically, this will be the web address where Teamspace is hosted. For this guide, we'll use http://localhost:3000/api/auth/callback/asgardeo, as the app will be accessible at this URL

  5. Allow sharing the application with organizations and click "Create".

    Note

    You can also do this later from the “Advanced” tab of the created application as-well.

    Allow sharing app

  6. Once you create the application, you will be directed to the Quick Start tab of the created application.

Make a note of the following values from the Protocol and Info tabs of the registered application. You will need them to configure the app in later steps.

  • Client ID from the Protocol tab.
  • Client Secret from the Protocol tab.
  • Issuer from from the Info tab.
  • Logout from from the Info tab.

Allow required grant types

To ensure seamless authentication and authorization in the Teamspace application, you must allow the necessary OAuth2 grant types in Asgardeo. These grant types allow your app to authenticate users, retrieve access tokens, and interact with Asgardeo’s APIs securely.

Required Grant Types for Teamspace

Based on the features we are expecting to implement, the following grant types are enabled:

  • Authorization Code Grant – Used for user authentication and obtaining access tokens interactively.
  • Client Credentials Grant – Allows the app to make API calls on behalf of the organization (used for retrieving a root organization token).
  • Organization Switch Grant – Enables switching between organizations.

How to Enable Grant Types

  1. Navigate to your application in the Asgardeo console.
  2. Click on "Protocols" tab
  3. Allow the above grant types and update

App Grants

Info

Read more on OAuth2 grant types