Connect Your App

Congratulations! You have succesfully set up an RBAC Policy!

All you have left to do is to follow the instructions on your screen to connect Permit into your application.

Remember that once you connect your app to Permit, you will need to run your application locally and navigate to localhost:4000 to see the results.

Integrate Permit into your own application

To integrate Permit.io into your own application, you can use the Permit SDK or work with the API directly.

Let's say that you have a web app that uses the Permit SDK to check for permissions. In the app, each user that signs in should have a unique identifier - such as:

• user-id
• email
• Auth0Id
• CognitoId

Your user object probably looks something like the one below (an example from Auth0):

Example user object

{
    "user": {
        "id": "abc123livrjeoigv",
        "tenant": "my-tenant",
        "username": "user1",
        "password": "xxxxxxx",
        "email": "user1@foo.com",
        "first_name": "John",
        "last_name": "Smith",
        "emailVerified": true
    }
}

Sync user

This SDK function is used to sync a user's data with the Permit.io PDP upon the users creation.

note

Once the user has been synced with Permit, you should not use this API call anymore to update the user's Role. Use assignRole instead.

.Net

UserKey userObj = new UserKey(user.id, user.first_name, user.last_name, user.email);
permit.Api.SyncUser(userObj);

Python (asyncio)

user = UserInput(user.id, user.first_name, user.last_name, user.email)
permit.write(permit.api.sync_user(user.customId, user.first_name, user.last_name, user.email))

Java

User userObj = new User.Builder(user.id)
    .withEmail(user.email)
    .withFirstName(user.first_name)
    .withLastName(user.last_name)
    .build();
user = permit.api.syncUser(userObj);

NodeJS

const userData: IPermitUser = {
    key: user.id,
    firstName: user.first_name,
    lastName: user.last_name,
    email: user.email,
    roles: [
        {
            role: "admin",
            tenant: board.id,
        },
    ],
};
await permit.write(permit.api.syncUser(userData));

Assign user

To update a user's role after a user has been synced/created, you can use the following function.

.Net

assignedRole = await permit.Api.AssignRole(user.customId, Role.id, Tenant.externalId);

Python (asyncio)

permit.write(permit.api.assign_role(user.customId, Role.key, Tenant.key))

Java

assignedRole = permit.api.assignRole(user.customId, Role.key, Tenant.externalId);

NodeJS

assignedRole = permit.api.assignRole(user.customId, Role.key, Tenant.key);

List roles

To get the available roles, you can use the following function:

.Net

Role[] roles = await permit.Api.GetRoles();

Python (asyncio)

getRole

Get a single tenant role, if such role exists.

Parameters

role_id - The id of the role. This can also be the role key.

Implementation

roles = await permit.api.get_role(role_id)

Java

RoleAssignmentList roles = permit.Api.getAssignedRolesInAllTenants();

NodeJS

ISyncedRole[] roles = permit.cache.getRoles();

Manage resources

To sync your resources and actions you can use our Web Application.

Or you can use the SyncResources SDK function that you can find under the relevant language, in the SDK navigation panel.

List tenants

To get the available tenants, you can use the following API Call.