You will need roughly 8 minutes to read this article.
Let’s take a look at how CodeShip manages permissions around your source control, your builds and your team.
When we say permissions, we are talking about access you give CodeShip to your source control repo, or access you give to people on your team to your CodeShip builds and account information.
In terms of access you give CodeShip, there are two different types that are in play: repository level permissions (for setting up new projects on CodeShip) and access level permissions (for authenticating with an SCM instead of username/password).
To configure CodeShip with your Bitbucket or Gitlab repository correctly, the account that connects a repository needs to have the necessary permissions to setup a webhook, add deploy keys, update commit statuses, as well as clone the code in your repositories. For the initial configuration of CodeShip, we expect the user’s account to have
admin permissions (or
owner depending on your source control system) to allow us to properly configure your SCM.
In case a user will not need to setup new projects on CodeShip, we mainly need to
Github works slightly different, and requires that you to install the CodeShip Github App first, and then allow the app access to the repositories you want to use on CodeShip. You can select only the repositories you want us to have access to, or all repositories (incl. future ones). We suggest you only allow access to specific repositories to keep control on who can access what. For you to setup the github app, you must have permission to install apps on your organization and configure them. Once the app has been installed, users who setup new projects mainly need to have access to the repository, but do not need permission to install apps.
As for access level permissions, we aim to request as few permissions as possible for users, but for some SCMs this is not possible, yet. Github is an example where we only ask for permissions to authenticate the user as well as the email, where as Gitlab only lets us ask for access to everything.
The next section explains which specific permissions we ask for, depending on your source control system.
As mentioned above, CodeShip requires both repository and access level permissions. Depending on the source control service being used, these are called something different:
webhook). You can see the full list of permission options available from BitBucket here.
apiscope), which unfortunately gives us access to everything on the repo. We wish it was different, but as of now, GitLab only provides two options where only one will allow us to access your repos.
You can learn more about organization management on CodeShip by clicking here, but in general there are four basic security levels for teams on CodeShip:
Owners have control over all aspects of an organization. From changing the subscription to managing organization projects and teams.
Managers have control over team and project management of an organization. They can add and remove projects and manage the organization teams by adding new team members or assigning projects to teams. They have access to all projects and are able to change the project configuration.
Project Managers can manage projects the team is assigned to. They can debug builds, update test settings, or manage deployments.
Contributors have read-only access to their projects. This means that they can view the project dashboard and build details but are not allowed to change project settings or open debug builds.
Note this only applies to Github.
If the repositories for a GitHub organization don’t show up on CodeShip, please head over to the settings for the CodeShip application on GitHub and in the section labeled Organization access either
Once this is done and access has been granted, the organizations repositories will show up in the repository selector on CodeShip again.
See GitHub’s help article on 3rd party restrictions for more background information about this feature.
If you attempt to connect a repository to a new project, and you don’t have
admin permissions on that repository (or, for Github don’t have permission to install the CodeShip Github App), there are two things you can do:
adminpermissions to the repo, which can be given to the team you’re in or specifically to your user
adminpermissions, setup the project for you. The flow would look like this:
adminpermission creates the project and connects the repo (CodeShip will create a webhook and register an SSH key)
You can learn more about security on CodeShip by clicking here.
There are two CodeShip services, and staff have different levels of access for each:
On CodeShip Basic, with your permission, our support team can open an SSH debug session into your build machine, which allows us to see your source code.
On CodeShip Pro, we have no direct access to your source control, but our support team can see your builds and build logs, as well as account information.
Contact our support team or post on Stack Overflow using the tag
#codeship. Did you check the status page and changelog?
There are also several code examples and sample projects available for you to get started with.