Create a first application

Introduction

All applications secured with LeZa use the LeZa proxy as an access gateway. The proxy can be deployed on any cloud provider infrastructure or local server by the application/service owner (client). In order to configure the LeZa proxy, you must first register your application and get a Client ID and a Client Secret

Registering your application

In order to get your application registered. You will generate a client/application Id and client/application secret for the authentication layer. You need to follow these steps:

1) Click on the application tab from the left sidebar.

2) Click on plus icon (+) button to create a new application.

3) Complete the registration form

1. Add an application name - this is your application/service name.

2. Add a callback url - this is the URL where your application/service is hosted.

3. Click on the "Ok" button.

Register services

Services are parts of your application or can be the whole application itself. In modern architectures we prefer to separate different units of logic in "micro-services" these micro-services are poorly coupled which makes development and maintenance easier.

In order to register a service use the following steps:

1) Click on the services tab from the main menu.

2) Click on the plus icon (+) button on the top right of your main screen to create the new service.

3) Add a name for your service, this name will help you to identify your service on LeZa

4) Add a URL for your service

5) Add a base path of your service, the base path is the pattern of your service path in the URL.

6) Add a service logo, in order to recognize it easily.

Select if your service is private or public, a public service can be accessed without being logged in (like a front-end for example in certain cases).

7) Click on the "Ok" button

Your service should now be created and be ready to use.

Create endpoints

An end-point is a function accessible through your service. Each endpoint is determined by its path. Configuring endpoints will allow you to create custom rules to control access to those endpoints, we highly recommend you register all of your endpoints in order to get the most out of LeZa.

In order to start creating endpoints, you must click on an already created service (Go to the previous section to create a service). Then go on the endpoints section and click on the little plus (+) button.

1) Go to the endpoints tab

2) Click on add endpoint

Complete the following information:

1. Enter the name of your service endpoint, we recommend naming it according to its function for easy identification purposes

2. Enter the name of your resource. Recommendation: Depending on the information that the resource manages, you should name it accordingly (for example if the API returns oranges you should call it oranges)

3. Select the HTTP method type - (GET, POST, PUT, DELETE)

4. Enter the service path to reach the function

5. Click on "next" to finish the creation of the endpoint

Attach services to your application

After registering your services and creating their endpoints accordingly you will need to attach them with the corresponding application. To do this follow these steps:

1. Click on the "application tab" from the left sidebar.

2. Go to the details view by clicking on the "edit" action icon.

3. Click on the "services" tab.

4. Click on the "attach" toggle button to attach a service to the application.

Now your application is now set up and almost ready to go 🙌 See setting up access control next.