Community
Questions Library
Docs
Blog
Events
Swag
Github
Slack
JupiterOne
Discussions
Release Notes
Contact Us
Creating `Team` Entities and Mapping Team Members - AskJ1 Community
<main> <article class="userContent"> <p>This guide walks through the process of creating <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">Team</code> entities and mapping team members to the <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">Person</code> entities (that are already integrated via SSO/IdP providers) to each team.</p> <p>This can be accomplished by uploading a JSON/YAML document containing the <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">Team</code> entities either via the JupiterOne app UI or the platform API.</p> <h2 data-id="ui">UI</h2> <p>Under the Assets section of the application, click the + button in the upper-right corner.</p> <p><img src="https://us.v-cdn.net/6035534/uploads/V6DH8Q2JM0IU/add-asset.png" alt="add-asset" class="embedImage-img importedEmbed-img"></img></p> <p>Click the tile "Bulk upload from a JSON or YAML file".</p> <p><img src="https://us.v-cdn.net/6035534/uploads/6QOWT5HSWNCL/bulk-upload.png" alt="bulk-upload" class="embedImage-img importedEmbed-img"></img></p> <p>Use the following JSON as an example:</p> <pre class="code codeBlock" spellcheck="false" tabindex="0">{ "entities": [ { "_key": "my_team:1", "_type": "my_team", "_class": "Team", "displayName": "Team One", "name": "Marketing Team", "description": "One person team", "email": "james@jupiterone.com", "members": ["james@jupiterone.com"] }, { "_key": "my_team:2", "_type": "my_team", "_class": "Team", "displayName": "Team Two", "name": "Solutions Team", "description": "Customer facing team", "email": "solutions@jupiterone.com", "lead": "cindy@jupiterone.com", "members": [ "cindy@jupiterone.com", "james@jupiterone.com", "mark@jupiterone.com" ] } ] } </pre> <h2 data-id="api">API</h2> <p>This process can also be accomplished via the JupiterOne API using the JSON example above. See the document <a rel="nofollow" href="https://jupiterone.vanillacommunities.com/kb/articles/979-bulk-upload">Bulk Upload</a> for more info.</p> <h3 data-id="some-key-things-to-note">Some key things to note:</h3> <ul><li>The <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">_key</code> must be unique for each team</li> <li><code class="code codeInline code codeInline" spellcheck="false" tabindex="0">"members"</code> are mapped to <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">Person</code> entities by email, creating <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">Team -HAS-> Person</code> relationships</li> <li><code class="code codeInline code codeInline" spellcheck="false" tabindex="0">"lead"</code> or <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">"manager"</code> or <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">"supervisor"</code> is also mapped to a <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">Person</code> entity by email, creating <code class="code codeInline code codeInline" spellcheck="false" tabindex="0">Person -MANAGES-> Team</code> relationships</li> <li>Currently JSON/YAML are the only supported formats to define custom entities/Teams. CSV support will be available soon to allow users to modify a spreadsheet instead.</li> </ul> </article> </main>
.png)