Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings
This repository was archived by the owner on Nov 1, 2017. It is now read-only.

Commit97af233

Browse files
committed
Merge pull request#704 from tamsky/clarify-machine-users-vs-deploy-keys
Clarify access granted by deploy keys vs teams vs collaborators.
2 parentscd7a8c3 +b84cec9 commit97af233

File tree

1 file changed

+4
-5
lines changed

1 file changed

+4
-5
lines changed

‎content/guides/managing-deploy-keys.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ A deploy key is an SSH key that is stored on your server and grants access to a
6969
####Cons
7070

7171
* Deploy keys only grant access to a single repository. More complex projects may have many repositories to pull to the same server.
72-
*The key hasfull read/write access tothe repository.
72+
*Deploy keys always providefull read/write access toa repository.
7373
* Deploy keys are usually not protected by a passphrase, making the key easily accessible if the server is compromised.
7474

7575
####Setup
@@ -88,11 +88,11 @@ A deploy key is an SSH key that is stored on your server and grants access to a
8888

8989
##Machine users
9090

91-
If your server needs to access multiple repositories, you can choose to attach an SSH keyto an automated user account.Since this account won't be used by a human, it's called a machine user. You can then[add the machineaccount as collaborator][collaborator] or[add the machine user to a team][team] with access to the repositories it needs to manipulate.
91+
If your server needs to access multiple repositories, you can choose tocreate a new GitHub account andattach an SSH keythat will be used exclusively for automation.Since thisGitHubaccount won't be used by a human, it's called a machine user.You can then[add the machineuser as collaborator][collaborator] or[add the machine user to a team][team] with access to the repositories it needs to manipulate.**NOTE**: Adding a machine user as a collaborator always grants read/write access. Adding a machine user to a team grants the permissions of the team.
9292

9393
<divclass="alert">
9494
<p>
95-
<strong>Tip</strong>: Our <ahref="https://help.github.com/articles/github-terms-of-service">terms of service</a> do mention that <em>'Accounts registered by "bots" or other automated methods are not permitted.'</em> and that <em>'One person or legal entity may not maintain more than one free account.'</em> But don't fear, we won't send rabid lawyers out to hunt you down if youmake machine users for your server deploy scripts. Machine users are completely kosher.
95+
<strong>Tip</strong>: Our <ahref="https://help.github.com/articles/github-terms-of-service">terms of service</a> do mention that <em>'Accounts registered by "bots" or other automated methods are not permitted.'</em> and that <em>'One person or legal entity may not maintain more than one free account.'</em> But don't fear, we won't send rabid lawyers out to hunt you down if youcreate machine users for your server deploy scripts. Machine users are completely kosher.
9696
</p>
9797
</div>
9898

@@ -101,11 +101,10 @@ If your server needs to access multiple repositories, you can choose to attach a
101101
* Anyone with access to the repository and server has the ability to deploy the project.
102102
* No (human) users need to change their local SSH settings.
103103
* Multiple keys are not needed; one per server is adequate.
104-
* Organizations can give read-only access to their machine users.
105104

106105
####Cons
107106

108-
*By default, the key has full read/writeaccess tothe repository if the repository belongs to a user account. You can add themachineuser toaread-onlyteam if it's accessingrepositoriesin an organization.
107+
*Only organizations haveaccess tocreate teams; therefore only organizations can use them to restrictmachineusers to read-onlyaccess. Personalrepositoriesalways grant collaborators read/write access.
109108
* Machine user keys, like deploy keys, are usually not protected by a passphrase.
110109

111110
####Setup

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp