Manage a Team in Censys Search
Censys Search Teams maximizes the value of your Censys Search account for your organization. Your organization can leverage the additional features in your plan, including shared quota.
If you want to add a team member in Attack Surface Management, first add them to Censys Search.
Access Team and member management
Team management is not available through the API. To manage your Team, log in to the Censys Search web app.
Open the user menu in the upper right of the page and click My Account. The following subpages are accessible from the Team tab:
-
Details: The name of your Team and a button to update it.
-
Members: A list of the members and admins of your team. This is where you can add new users and modify team roles.
-
Team members can view their full team, but cannot make any changes.
-
Team admins can update the team details and manage members of the team.
-
- Authentication: Configure SSO access for your Team. Articles in this section explain how to set up SSO.
Manage your Team members
The process for managing Team members differs slightly depending on whether you use SSO to handle access to Censys Search.
Add a new member to a Censys Search Team using SSO
To add an entirely new user without a preexisting Censys Free account to a Censys Team managed via SSO:
- Grant the user access to Censys Search in your IdP.
- The exact process for this differs depending on which SSO provider you are using. Examples are provided for common SSO integrations in our documentation.
- Direct the user to log in to Censys Search using the email used for your IdP. They will be redirected to your login provider to complete authentication.
To add a user with an existing Censys Free account to an SSO-managed Censys Search Team, contact Censys Support at support@censys.io. Adding an existing Free user to a Search Team requires approval from an administrator for that Team.
Add a new member to a Censys Search Team without using SSO
If you do not use SSO to manage access to your Censys Team, you can add users using the following process. This action can only be performed by Team Admins.
Note
Note that in order to accept the invitation sent as a result of this process, the recipient must have an existing Censys Search account associated with the email the invitation is sent to.
- To invite someone to join your team, open the Censys Search web interface and navigate to My Account > Team > Members.
- Scroll to the bottom of the page to the Invite a User section. Type in the email address of the user to invite in the text box, and click Invite.
After they accept the invitation, the new user is part of your team and you can manage them like other team members.
Invitations expire after 72 hours. If the invitation is not accepted in that time period, you need to generate a new invitation.
Troubleshoot a login issue
If you or person you invited to your team is having difficulty with the email verification or you're seeing errors related to a retry flow or invalid token, visit the Recover Account page. Follow the instructions there, and reach out to support@censys.io if you continue to have issues.
Change a user’s role
Admins can be changed to members, and members can be changed to admins. There is no limit on the number of admins a team can have. To change someone’s role, navigate to the Team Members subpage and click the three-dot options menu next to their name.
Demote an admin
Demoting an admin removes their ability to update team details and manage members. Use the three-dot options menu in the member's row in the team listing to remove admin permissions.
Remove a member
A member who is removed from a Team retains their Censys account and can query Censys with a Censys Search Community account. To remove someone from the team, scroll to their name in the Team Members table and click Remove from team. Users with an admin role cannot be removed. If you need to remove an admin user, demote them and then remove them.