{"_id":"590a04faed80861900cbc7cb","category":{"_id":"590a04f3ed80861900cbc74a","__v":0,"version":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","sync":{"url":"","isSync":false},"reference":false,"createdAt":"2016-11-09T19:14:56.849Z","from_sync":false,"order":20,"slug":"app-access-management","title":"Manage App"},"user":"55b2d5626862a10d00887af9","parentDoc":null,"__v":0,"version":{"_id":"590a04f2ed80861900cbc737","project":"55b2d5baa74a380d00e290c4","__v":4,"createdAt":"2017-05-03T16:27:30.085Z","releaseDate":"2017-05-03T16:27:30.085Z","categories":["590a04f3ed80861900cbc738","590a04f3ed80861900cbc739","590a04f3ed80861900cbc73a","590a04f3ed80861900cbc73b","590a04f3ed80861900cbc73c","590a04f3ed80861900cbc73d","590a04f3ed80861900cbc73e","590a04f3ed80861900cbc73f","590a04f3ed80861900cbc740","590a04f3ed80861900cbc741","590a04f3ed80861900cbc742","590a04f3ed80861900cbc743","590a04f3ed80861900cbc744","590a04f3ed80861900cbc745","590a04f3ed80861900cbc746","590a04f3ed80861900cbc747","590a04f3ed80861900cbc748","590a04f3ed80861900cbc749","590a04f3ed80861900cbc74a","590a04f3ed80861900cbc74b","590a04f3ed80861900cbc74c","590a04f3ed80861900cbc74d","59124949de13f61900336a7a","5914b04e7c2c552d008b7104","5914b47242c6a22300b9dc20"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"7.0.0","version":"7"},"project":"55b2d5baa74a380d00e290c4","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-09-20T21:55:24.991Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"There are two ways to invite team members to collaborate on your app in buddybuild!\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Quick links\",\n  \"body\": \"<a href=\\\"http://docs.buddybuild.com/v6/docs/manage-app-access#section-option-1-automatic-team-member-access-with-githug-bitbucket-or-gitlab\\\">Option 1: Automatic team member access with GitHub, Bitbucket or GitLab</a>\\n<a href=\\\"http://docs.buddybuild.com/docs/manage-app-access#section-option-2-invite-team-members-through-buddybuild\\\">Option 2: Invite team members through buddybuild</a>\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Option 1: Automatic team member access with GitHub, Bitbucket or GitLab\"\n}\n[/block]\nIf you have signed up for buddybuild with **[GitHub](doc:signing-up-with-github), [Bitbucket](doc:signing-up-with-bitbucket) or [GitLab](doc:signing-up-with-gitlab) OAUTH**, buddybuild automatically allows repository collaborators access to your app! These members simply need to sign up with buddybuild, and they will automatically see the app.\n\nFirst, select **App Settings** in the global navigation.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1ef2498-Builds_-_Settings.png\",\n        \"Builds - Settings.png\",\n        1500,\n        483,\n        \"#ecf1f2\"\n      ]\n    }\n  ]\n}\n[/block]\nIn the left navigation, select **Manage collaborators**. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3dc2d74-Settings_-_Manage_Team_-_1.jpg\",\n        \"Settings - Manage Team - 1.jpg\",\n        1500,\n        496,\n        \"#2981d4\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nYou will find team members who have automatic collaborator access to your app under **Synchronized from your repository**.\n\nSelect **Manage their access in GitHub (or Bitbucket or GitLab)** to manage access for these collaborators.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/7d64360-Settings_-_Manage_Team_-_5.jpg\",\n        \"Settings - Manage Team - 5.jpg\",\n        1500,\n        798,\n        \"#e8ebee\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\n###App Access Roles\nTo change a team member's access level, simply specify whether they should have 'Full Access' or 'Read-Only Access' through the Access dropdown by the name of each collaborator. \n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Read only vs. Full Access\",\n  \"body\": \"Members with **Read-Only Access** are able to view the buddybuild dashboard, click through build history, download and install builds, sort user feedback and draw insights from crash reports. They cannot make any changes to buddybuild's SDK settings, integrations, notifications, or perform any app management (such as renaming or deleting the app). They aren't able to create or deploy builds, upload to the App Store, or open/close user feedback or crash reports.\\n\\nMembers with **‘Full Access’** in the buddybuild dashboard have complete control over the app, including all of the app settings, kicking off or scheduling builds, managing deployment groups and changing app and build configurations.\\n\\nRegardless of their access level, all users have the ability to manage their user profiles as well as their organization's plan and billing information.\"\n}\n[/block]\n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/06b1d51-Settings_-_Manage_Team_-_6.jpg\",\n        \"Settings - Manage Team - 6.jpg\",\n        1500,\n        401,\n        \"#d7dbdd\"\n      ]\n    }\n  ]\n}\n[/block]\n\n[block:api-header]\n{\n  \"title\": \"Option 2: Invite team members through buddybuild\"\n}\n[/block]\nIf you have onboarded your app with buddybuild through SSH, or if you would like to invite someone who is not a repository collaborator in GitHub, Bitbucket or GitLab, you can manually invite them through buddybuild.\n\nUnder **Manually invited through buddybuild**, invite one or more team members by entering their email addresses.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9db8d99-Settings_-_Manage_Team_-_2.jpg\",\n        \"Settings - Manage Team - 2.jpg\",\n        1500,\n        376,\n        \"#dde0e2\"\n      ]\n    }\n  ]\n}\n[/block]\nNext to the email addresses, specify whether they should have 'Full Access' or 'Read-Only Access' through the Access dropdown and click **Add** when you're done.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/8e8c838-Settings_-_Manage_Team_-_2a.jpg\",\n        \"Settings - Manage Team - 2a.jpg\",\n        1500,\n        496,\n        \"#dde1e3\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nInvited team members will receive an email invite to your app. From there, they can **accept the invite and join the project.** \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/3b43291-Settings_-_Manage_Team_-_3.jpg\",\n        \"Settings - Manage Team - 3.jpg\",\n        3000,\n        1596,\n        \"#f1f8f9\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]\nInvitees who do not have an account in buddybuild will be prompted to create one. When that process is complete, the specific team member will be able to access your app in buddybuild!\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/358ad6e-Settings_-_Manage_Team_-_4.jpg\",\n        \"Settings - Manage Team - 4.jpg\",\n        1500,\n        493,\n        \"#dce1e4\"\n      ],\n      \"sizing\": \"full\"\n    }\n  ]\n}\n[/block]","excerpt":"","slug":"manage-app-access","type":"basic","title":"Manage App Access"}
There are two ways to invite team members to collaborate on your app in buddybuild! [block:callout] { "type": "info", "title": "Quick links", "body": "<a href=\"http://docs.buddybuild.com/v6/docs/manage-app-access#section-option-1-automatic-team-member-access-with-githug-bitbucket-or-gitlab\">Option 1: Automatic team member access with GitHub, Bitbucket or GitLab</a>\n<a href=\"http://docs.buddybuild.com/docs/manage-app-access#section-option-2-invite-team-members-through-buddybuild\">Option 2: Invite team members through buddybuild</a>" } [/block] [block:api-header] { "title": "Option 1: Automatic team member access with GitHub, Bitbucket or GitLab" } [/block] If you have signed up for buddybuild with **[GitHub](doc:signing-up-with-github), [Bitbucket](doc:signing-up-with-bitbucket) or [GitLab](doc:signing-up-with-gitlab) OAUTH**, buddybuild automatically allows repository collaborators access to your app! These members simply need to sign up with buddybuild, and they will automatically see the app. First, select **App Settings** in the global navigation. [block:image] { "images": [ { "image": [ "https://files.readme.io/1ef2498-Builds_-_Settings.png", "Builds - Settings.png", 1500, 483, "#ecf1f2" ] } ] } [/block] In the left navigation, select **Manage collaborators**. [block:image] { "images": [ { "image": [ "https://files.readme.io/3dc2d74-Settings_-_Manage_Team_-_1.jpg", "Settings - Manage Team - 1.jpg", 1500, 496, "#2981d4" ], "sizing": "full" } ] } [/block] You will find team members who have automatic collaborator access to your app under **Synchronized from your repository**. Select **Manage their access in GitHub (or Bitbucket or GitLab)** to manage access for these collaborators. [block:image] { "images": [ { "image": [ "https://files.readme.io/7d64360-Settings_-_Manage_Team_-_5.jpg", "Settings - Manage Team - 5.jpg", 1500, 798, "#e8ebee" ], "sizing": "full" } ] } [/block] ###App Access Roles To change a team member's access level, simply specify whether they should have 'Full Access' or 'Read-Only Access' through the Access dropdown by the name of each collaborator. [block:callout] { "type": "info", "title": "Read only vs. Full Access", "body": "Members with **Read-Only Access** are able to view the buddybuild dashboard, click through build history, download and install builds, sort user feedback and draw insights from crash reports. They cannot make any changes to buddybuild's SDK settings, integrations, notifications, or perform any app management (such as renaming or deleting the app). They aren't able to create or deploy builds, upload to the App Store, or open/close user feedback or crash reports.\n\nMembers with **‘Full Access’** in the buddybuild dashboard have complete control over the app, including all of the app settings, kicking off or scheduling builds, managing deployment groups and changing app and build configurations.\n\nRegardless of their access level, all users have the ability to manage their user profiles as well as their organization's plan and billing information." } [/block] [block:image] { "images": [ { "image": [ "https://files.readme.io/06b1d51-Settings_-_Manage_Team_-_6.jpg", "Settings - Manage Team - 6.jpg", 1500, 401, "#d7dbdd" ] } ] } [/block] [block:api-header] { "title": "Option 2: Invite team members through buddybuild" } [/block] If you have onboarded your app with buddybuild through SSH, or if you would like to invite someone who is not a repository collaborator in GitHub, Bitbucket or GitLab, you can manually invite them through buddybuild. Under **Manually invited through buddybuild**, invite one or more team members by entering their email addresses. [block:image] { "images": [ { "image": [ "https://files.readme.io/9db8d99-Settings_-_Manage_Team_-_2.jpg", "Settings - Manage Team - 2.jpg", 1500, 376, "#dde0e2" ] } ] } [/block] Next to the email addresses, specify whether they should have 'Full Access' or 'Read-Only Access' through the Access dropdown and click **Add** when you're done. [block:image] { "images": [ { "image": [ "https://files.readme.io/8e8c838-Settings_-_Manage_Team_-_2a.jpg", "Settings - Manage Team - 2a.jpg", 1500, 496, "#dde1e3" ], "sizing": "full" } ] } [/block] Invited team members will receive an email invite to your app. From there, they can **accept the invite and join the project.** [block:image] { "images": [ { "image": [ "https://files.readme.io/3b43291-Settings_-_Manage_Team_-_3.jpg", "Settings - Manage Team - 3.jpg", 3000, 1596, "#f1f8f9" ], "sizing": "full" } ] } [/block] Invitees who do not have an account in buddybuild will be prompted to create one. When that process is complete, the specific team member will be able to access your app in buddybuild! [block:image] { "images": [ { "image": [ "https://files.readme.io/358ad6e-Settings_-_Manage_Team_-_4.jpg", "Settings - Manage Team - 4.jpg", 1500, 493, "#dce1e4" ], "sizing": "full" } ] } [/block]