title | description |
---|---|
Projects |
Learn more and understand the concept of Infisical projects. |
A project in Infisical belongs to an organization and contains a number of environments, folders, and secrets. Only users and machine identities who belong to a project can access resources inside of it according to predefined permissions.
Infisical also allows users to request project access. Refer to the project access request section
For both visual and organizational structure, Infisical allows splitting up secrets into environments (e.g., development, staging, production). In project settings, such environments can be customized depending on the intended use case.
The Secrets Overview page captures a birds-eye-view of secrets and folders across environments. This is useful for comparing secrets, identifying if anything is missing, and making quick changes.
The Secrets Dashboard page appears when you press to manage the secrets of a specific environment.
To add a secret, press Add Secret button at the top of the dashboard.
For a new project, it can be convenient to populate the dashboard by dropping a .env
file into the provided pane as shown below:
To delete a secret, hover over it and press the X button that appears on the right side.
To delete multiple secrets at once, hover over and select the secrets you'd like to delete and press the Delete button that appears at the top.
To search for specific secrets by their key name, you can use the search bar.
To assist you with finding secrets, you can also group them by similar prefixes and filter them by tags (if applicable).
To view/hide all secrets at once, toggle the hide or un-hide button.
To download/export secrets back into a .env
file, press the download button.
To better organize similar secrets, hover over them and label them with a tag.
To provide more context about a given secret, especially for your team, hover over it and press the comment button.
Infisical employs the concept of shared and personal secrets to address the need
for common and custom secret values, or branching, amongst members of a team during software development.
To provide a helpful analogy: A shared value is to a main
branch as a personal value is to a custom branch.
Consider:
- A team with users A, B, user C.
- A project with an environment containing a shared secret called D with the value E.
Suppose user A overrides the value of secret D with the value F.
Then:
- If user A fetches the secret D back, they get the value F.
- If users B and C fetch the secret D back, they both get the value E.
To view the full details of each secret, you can hover over it and press on the ellipses button.
This opens up a side-drawer: