Skip to main content

Adding Relationship Tuples

A relationship tuple is a base tuple/triplet consisting of a user, relation, and object. You can add tuples on the FGA Dashboard.

  1. In the Tuple Management page, you may add relationship tuples in the Tuple Editor panel located on the left part of the page.

    Image showing the tuples editor

  2. Click Add Tuple+ to add new relationship tuples.

    Image showing the tuples editor add tuples button

  3. This will bring up the input for User, Object and Relation.

  • For the USER text box, type in the user identifier. Make sure the user identifier is in the correct format.

  • For the OBJECT line, the drop down list allows you to choose the type and the text box allows you type in the object name.

  • For the RELATION there will be a drop down selector allowing you to choose from the type's possible relations.

    Image showing the relationship tuples input box

  1. Click the check mark button to save. The X button will cancel the changes.

    Image showing the relationship tuples being added

  2. The added relationship tuples will be shown in the tuples editor panel.

    Image showing after the relationship tuples are added

  3. Relationship tuples may be removed by clicking the trash can button.

    Image showing location of trash can button

note

The Dashboard will only display a maximum of 100 tuples. This is a current limitation of the Dashboard view. Use the FGA CLI or API to retrieve all tuples.

Manage conditions

If you have conditions defined on your model, whenever you add a tuple for a relation that can be conditioned, an Add Condition option is displayed.

Image showing adding a tuple with a condition

When you click on Add Condition, a new panel opens where you can specify the condition name and the parameters you want to instantiate in the tuple itself. In this case, the condition name is non_expired_grant, the current_time is not specified, the grant_time is at midnight October 14th, 2024 and the grant duration is 10 seconds.

Image showing adding a tuple with a condition

Whenever you add an assertion, you will see an Add Context option.

Image showing adding an assertion with a condition

When you click on Add Context, a new panel is opened to specify the contextual parameters. Auth0 FGA shows specialized field editors depending on the data type.

Image showing adding an assertion with a condition

Have Feedback?

You can use any of our support channels for any questions or suggestions you may have.