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.

Commitc237c01

Browse files
committed
Clarify deploy keys and collaborators are always granted read/write access.
Clarify difference between machines users on a team vs machines users as collaborator.Clarify machine accounts are 'github user accounts'.Clarify user-owned repos are unable to grant read-only access.
1 parentcd7a8c3 commitc237c01

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 accessing repositoriesin an organization.
107+
*Only organizations haveaccess tocreate teams; therefore only organizations can use them to restrictmachineusers to read-onlyaccess. Individual user-owned repositoriesalways grant read/write to collaborators.
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