diff --git a/docs/acls.md b/docs/acls.md index f72499e5f..3a048fbcf 100644 --- a/docs/acls.md +++ b/docs/acls.md @@ -1,10 +1,10 @@ # ACLs -> ACLs are currently working for existing objects. Only a super admin (XO administrator) can create objects. +> ACLs are permissions that apply to pre-existing objects. Only a super admin (XO administrator) can create objects. -ACLs are the permissions for your users or groups. The ACLs view can be accessed in the "Settings". +ACLs are the permissions for your users or groups. The ACLs view can be accessed in the "Settings" panel. -1. Select the user or group you want to apply permissions on it +1. Select the user or group you want to apply permissions on 2. Select the object on which the permission will apply 3. Choose the role for this ACL 4. Click on "Create" @@ -21,7 +21,7 @@ You can edit/remove existing ACLs here. ## Roles -There is 3 different roles for your users: +There are 3 different roles for your users: * Admin * Operator @@ -66,7 +66,7 @@ If you give a *view* permission to a user (or a group) on a pool, he will automa ### Allow a user to install an OS -If the OS install needs a ISO, you need to give this user 2 permissions: +If the OS install needs an ISO, you need to give this user 2 permissions: * *Operate* on the VM (e.g to start it) * *View* on the ISO Storage containing the needed ISO. diff --git a/docs/github.md b/docs/github.md index d22e42948..0ccf431b4 100644 --- a/docs/github.md +++ b/docs/github.md @@ -2,15 +2,15 @@ This plugin allows GitHub users to authenticate to Xen-Orchestra. -The first time a user signs in, XO will create a new XO user with the same identifier, without any permission. +The first time a user signs in, XO will create a new XO user with the same identifier, without any permissions. First you need to configure a new app in your GitHub account: ![](https://raw.githubusercontent.com/vatesfr/xen-orchestra/master/packages/xo-server-auth-github/github.png) -When you got your `clientID` and your `clientSecret`, you can configure them in the GitHub Plugin inside "Settings/Plugins" view of Xen Orchestra. +When you get your `clientID` and your `clientSecret`, you can configure them in the GitHub Plugin inside the "Settings/Plugins" view of Xen Orchestra. -Be sure to activate the plugin after you save the configuration (button on top). When it's done, you'll see a link in the log in view, this is where you'll go to authenticate: +Be sure to activate the plugin after you save the configuration (button on top). When it's done, you'll see a link in the login view, this is where you'll go to authenticate: ![](./assets/githubconfig.png) diff --git a/docs/google.md b/docs/google.md index 91f2e9f89..51e126b84 100644 --- a/docs/google.md +++ b/docs/google.md @@ -2,7 +2,7 @@ This plugin allows Google users to authenticate to Xen-Orchestra. -The first time a user signs in, XO will create a new XO user with the same identifier, without any permission. +The first time a user signs in, XO will create a new XO user with the same identifier, without any permissions. ## Creating the Google project @@ -32,7 +32,7 @@ In Settings, then Plugins, expand the Google plugin detail and provide: Be sure to activate the plugin after you save the configuration (button on top). -You can now connect with your Google account in the log in page: +You can now connect with your Google account in the login page: ![Google log in]() diff --git a/docs/resources_delegation.md b/docs/resources_delegation.md index 935d98019..45b57d0f1 100644 --- a/docs/resources_delegation.md +++ b/docs/resources_delegation.md @@ -1,6 +1,6 @@ -# Resources delegation +# Resource Delegation -This chapter is about how to delegate resources (VM, hosts) to users. +This chapter covers how to delegate resources (VM, hosts, etc) to users. The idea is to allow external users (not admins) to: @@ -14,11 +14,11 @@ The idea is to allow external users (not admins) to: Groups are a set of users. You can use groups to apply permissions/ACLs on a whole set of users, instead of repeating superfluous operations on multiple users separately. -Groups can be created and managed in the "Groups" view inside "Settings" menu. +Groups can be created and managed in the "Groups" view inside the "Settings" menu. 1. Create a group by giving it a name 2. Edit this group and add users in it -Any group can be edited as you like after its creation. +Any group can be edited as needed after its creation. ![](./assets/groups.png)