Estimated time: 4 minutes
The basis of any integration is creating a client app in your workspace.
- 1.Choose your
App ID: it must be an ASCII combination that your app will use for integrating.
openid-connect- Entry uses this protocol for seamless secure integrations, originating from customer apps.
Next, you will configure your App and receive the parameters you will need to save on your backend.
For local development
Here we are providing the settings for your local development, assuming that you will be running a quickstart sample from our repo.
http://localhost/*in Valid Redirect URIs field - you will need this so that Entry would send you back to your app after successful login. On the screenshot below it's highlighted in blue.
- 2.Copy your Secret Key - you will need it for configuring your example.
- 3.Copy a domain part of the Authorization Endpoint (highlighted in green): in this case it's
entry-dev.xix.ai/auth/realms/testworkspace- note that you'll need to skip the "https://" part and the rest of the URL, the library will handle these parts for you.
That's it! Now you are ready to test Entry with a sample app or to integrate it with your Python app based on our quickstart.
Explore a sample app
Estimated time: 2 minutes
This is the part of the repo that stores the sample code:
- 1.Open your terminal.
- 2.Clone the repo and go to the
git clone https://github.com/XIX-Entry/quickstarts.git && cd web-app-python
- 3.Make a local copy of your
.envfile to store your configuration:
cp .env.example .env
- 4.Open your new
.envfile with your favorite text editor and put your settings into the file:
CLIENT_IDshould be your App ID from above, in this case
CLIENT_SECRETshould be your Secret key
WORKSPACEshould be the lowercase identifier of your workspace.
ENTRY_ENDPOINTa part of the Authorization Endpoint we've copied before:
APP_SECRET_KEYcan be just a random string.
- 5.Run you application with
- 6.Open your sample app in any browser at
http://localhost:3000- you will be able to log in into your sample app with Entry, and after being redirected, you will see the raw content of your user profile.