Manage your population of honeytokens
#
OverviewThe Honeytoken module homepage presents the list of your honeytokens, displaying the main information as well as the status of each one.
You can filter the honeytokens based on a number of filters:
- Type of honeytokens
- Source (monitored repositories where the honeytoken is located)
- Status (Active, Triggered, Revoked)
- Tag (
Publicly exposed
) - Labels
Clicking on the honeytoken name will direct you to its detail page.
- The Information section summarises the main information about your honeytoken and allows you to edit the name, description and labels.
- The Events section is where any usage of the honeytoken will get logged.
- The Timeline section provides the history of the honeytoken: when and where it was created, edited, deployed in a monitored source, triggered… It is also possible to add comments there.
#
Using labels to categorize your honeytokensLabels provide a flexible way to organize honeytokens. You can create your own labels in the form of keys and values, assign them to honeytokens, and use them to filter and search for honeytokens based on specific characteristics.
#
Manage labelsGo to Settings > Honeytoken to access the Labels settings page. From here, you can view the existing keys as well as the existing values for each key, and see how many honeytokens are categorized under them.
From this page, it will soon be possible to create, rename or delete labels. In the meantime, it is already possible to create labels directly when creating or editing a honeytoken.
#
Examples of use- Create one
place
key that can have the valuescodebase
,docker
,jenkins
,jira
,slack
... representing the type of location where the honeytoken is deployed. - Create one
team
key that can have values representing your teams and indicating which scope is covered by this honeytoken. - Create one
env
key that can have the valuesprod
,test
,staging
...
#
Assigning Labels to HoneytokensEach honeytoken can receive one or several labels. Please note that when assigning labels to a honeytoken, only one value from each key may be used.
#
Number of allowed honeytokensAWS honeytokens are available in a limited number. If you have reached this limitation, it is not possible to create new honeytokens anymore.
Revoked honeytokens are not included in the count of honeytokens. Only active and triggered honeytokens are included.
If you don’t have enough honeytokens, you can reach out to GitGuardian to discuss extending your limitation.