Difference between revisions of "Access Lists"
m (Update {{Merge}}) |
m (Rephrase.) |
||
(8 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | + | '''Access Lists''' ('''ACL'''<ref group=Note>The game calls it "Access List" but the concept is commonly called "[[:wikipedia:Access-control list|Access-control list]]". Thus the abbreviation "ACL".</ref>) are part of the system to control access to shared resources like [[Upwell structures]] and [[bookmark]]s. | |
− | '''Access Lists''' (ACL) are | ||
− | + | == Overview == | |
+ | An access list controls <em>who</em> has access to a shared resource. <em>What</em> permissions are set is handled by [[Bookmark#Share|shared folders]] for [[bookmark]]s and [[Structure permissions|profile]]s<!-- link for now, might need a separate article for profiles? --> for [[Upwell structures]]. An Access List has one or more members who are assigned one of the roles. | ||
− | == | + | === Role === |
+ | Members of an access list have one of the following roles: | ||
+ | * Admin - Can edit and delete the list. Can add and remove members (all roles). Can assign all roles. | ||
+ | ** {{Co|yellow|Caution:}} An admin <em>can</em> demote, block and remove themself. | ||
+ | * Manager - Can add members. Can remove members with the Member or Blocked role. Can assign the Member and Blocked role, but not to Admins or Managers. | ||
+ | ** {{Co|yellow|Caution:}} A manager <em>can</em> demote, block and remove themself. | ||
+ | * Member - Gains the permissions that are granted to the access list. Can not see the list in their Access List window and thus can not see who its members are. | ||
+ | * Blocked - Is effectively for shared bookmark folders or profiles "removed" from the list. It is used to exclude an entity that is added by a "higher" entity. | ||
+ | The Admin and Manager roles apply only to the access list itself. The permissions set on shared folders or in profiles count as having the Member role. However, as the Admin or Manager role needed to "see" the access list only admins and managers can assign access lists to shared folders or profiles provided they have the permission/corporation-role to do so. | ||
− | + | [[File:Access Lists window.png|thumb|upright= 1.8|The Access Lists window. <br>(1) List of access lists, (2) Access list details, (3) Add [[#Everyone|Everyone]] button, (4) Member [[#Search|search]] bar]] | |
+ | === Member === | ||
+ | Members of an access list can be: | ||
+ | * Everyone (Can only have the Member role) | ||
+ | * Alliances (Can not be Admin or Manager) | ||
+ | * Corporations (Can not be Admin or Manager) | ||
+ | * Capsuleers | ||
+ | {{Note box| | ||
+ | 25 August 2024: Despite [https://support.eveonline.com/hc/en-us/articles/208289645-Access-Lists EVE support] saying that it is not possible to add NPC-Corporations to an access list it did work. | ||
+ | }} | ||
− | + | Access lists are governed by the most granular setting available: | |
+ | * Alliance supersedes "Everyone" | ||
+ | * Corporation supersedes Alliance | ||
+ | * Capsuleer supersedes Corporation. | ||
− | + | === Built-in === | |
− | + | There is one built-in access list with one (Admin) member, the corporation the capsuleer is part of. It is named for the corporation (e.g. the one for the NPC corporation Republic University is named Republic University.) and can not be modified. So while the corporation has the Admin role (In contradiction with the rule that corporations can not be Admin or Manager) it effectively only makes the list visible and usable for all members of the corporation. | |
− | + | === Access Lists window === | |
+ | Access Lists are managed through the Access Lists window. The Access Lists window can be opened | ||
+ | * using the [[Neocom]] menu: Social > Access Lists | ||
+ | * using the Neocom short-cut icon: [[File:Accessgroups.png|22px]]Access Lists <ref group=Note>The short-cut area is player configurable so the icon may or may not be there</ref> | ||
+ | * using a [[Keyboard controls|hot-key]] (There is no default) | ||
− | + | The Access Lists window has the following components: | |
+ | # List of access lists | ||
+ | # Access list details of the selected access list | ||
+ | #* Access list name | ||
+ | #* Access list description | ||
+ | #* Role icon bar | ||
+ | #* List of members (tab) | ||
+ | #* Access list log (tab) | ||
+ | # Add [[#Everyone|Everyone]] button | ||
+ | # Member [[#Search|search]] bar | ||
+ | |||
+ | == Create == | ||
+ | Access Lists are created through the "Create a New Access List" window which has the following fields: | ||
+ | * Access List Name - The name of the access list (Required) | ||
+ | ** {{Co|Yellow|Caution:}} This name is only a label, duplicates are accepted with no warning! | ||
+ | * Access List Description - A description of the access list (Optional). The description shows at the top of the member list and as a tool-tip when hovering over the list name. | ||
+ | [[File:Create a New Access List window.png|thumb|The Create a New Access List window.]] | ||
+ | To create an access list: | ||
+ | * open the Access Lists window | ||
+ | * click the {{Button|+ New Access List}} button | ||
+ | * enter the name (Required) | ||
+ | * enter the description (Optional) | ||
+ | * click {{Button|Create}} | ||
+ | This will create an access list with one member, the creator, with the Admin role. | ||
+ | |||
+ | == Manage members == | ||
+ | Members are managed via the [[#Access Lists window|Access Lists window]]. The left side of the window shows the available access lists. The right side shows the details of the selected access list. The details shown are: name of the list, description of the list, the member list, and the logs. All changes to an access list are logged. The log can be viewed by selecting the "Access List Logs" tab on the right side of the Access List window. | ||
+ | |||
+ | === Add === | ||
+ | [[File:Access list-Add Members window.png|thumb|Add Members window]] | ||
+ | Members are added to an access list with the Member role and can be added in several ways. | ||
+ | |||
+ | * Clicking the {{Button|+ Add Members}} button. | ||
+ | : Opens the Add Member window. The Add Member window has Search and All Contacts tabs and activates an {{Button|Add Member}} button when one or more entities are selected. Using the button adds the selected entities to the selected Access List. The Search tab only finds eligible entities. Entities can also be dragged, either into the Access List Members tab of the selected Access List or on top of an access list name, adding the selected entities to that list. | ||
+ | * Using the Add Members option accessed by right-clicking the Access List name or by clicking the hamburger in the top right. | ||
+ | : Opens the [[Contacts]] window. The Contacts window has Contacts, Agents and Search tabs. The Agents tab is irrelevant as agents can not be members of an access list. The Search tab, by default, finds all types of entities but can be configured to only search characters or corporations etc. The Contacts window only supports dragging entities into the Access List Members tab of the selected access list or on top of an access list name, adding the selected entities to that list. | ||
+ | |||
+ | * Besides these methods, members can be added to an access list by dragging them from: | ||
+ | ** a chat channel or chat channel member list. | ||
+ | ** the Guests list in a station or player structure | ||
+ | ** the portrait/icon from an info window | ||
+ | |||
+ | * Members can also be copied from one access list to another by dragging them on top of an access list name. {{Co|red|Warning:}} This also copies the role. | ||
+ | |||
+ | ==== Everyone ==== | ||
+ | Everyone can only be added in one way. Clicking on the globe icon on the bottom right of the member list, adds everyone to the selected access list. | ||
+ | |||
+ | === Change role === | ||
+ | A member's role can be changed in several ways. Multiple members can be selected to change in one go. | ||
+ | [[File:Access Lists window-Role icon bar.png|thumb|The role icon bar.]] | ||
+ | * Drag members to the role icon bar on top of the member list | ||
+ | * Use the options in the member menu. This menu can be activated by right-clicking the member name or by clicking the hamburger in the top right. | ||
+ | ** The menu shows only applicable options - The possible options are: | ||
+ | *** Block Member | ||
+ | *** Unblock Member | ||
+ | *** Make Admin | ||
+ | *** Make Manager | ||
+ | *** Strangely enough, there is no option "Make Member". This is done by the options "Remove Admin Role" and "Remove Manager Role". | ||
+ | ** Corporations and alliances can not be blocked or unblocked via the menu they must be dragged to the role icon bar. | ||
+ | |||
+ | === Remove === | ||
+ | Members can be removed from an access list by the "Remove Member" option of the member menu. This menu can be activated by right-clicking the member name or by clicking the hamburger in the top right. | ||
+ | |||
+ | === Search === | ||
+ | [[File:Access Lists window-Search bar.png|thumb|The member search bar.]] | ||
+ | The [[#Access Lists window|Access Lists window]] has a search function (top-right of the window). The function acts as a filter. It limits the visible list members to those that match the filter. It also grays out Access Lists, which have no members that match the filter. The function is not dynamic, it requires hitting the {{Button|Enter}} key or clicking on the magnifying glass to activate. | ||
+ | |||
+ | Note: The entry field can be hidden. To make it visible again click on the magnifying glass or the << marker to the left of it. | ||
+ | |||
+ | == Edit == | ||
+ | An access list can be edited (name and description), through the option "Edit Access List" in the Access List menu. This menu can be activated by right-clicking the Access List name or by clicking the hamburger in the top right. | ||
+ | |||
+ | == Delete == | ||
+ | An access list can be deleted through the option "Delete Access List" in the Access List menu. This menu can be activated by right-clicking the Access List name or by clicking the hamburger in the top right. | ||
+ | |||
+ | == Publish == | ||
+ | Access lists can be "published" by dragging them into chat, a chat channel's MOTD), EVEmail, a character's biography or a corporation/alliance's description{{Verify|title= Is this true?}} creating a link. Clicking on the link opens a window<ref group=Note>The window opens in a size that shows only the list's name. It can be enlarged to show the other information.</ref> that shows the Access List's name, description and the Admin(s), but not the Managers. This information is not dynamic i.e. it is a snapshot of the information as is on the creation of the link. | ||
== See also == | == See also == | ||
+ | * EVE Support: [https://support.eveonline.com/hc/en-us/articles/208289645-Access-Lists Access Lists] | ||
+ | |||
+ | == Notes == | ||
+ | <References group=Note /> | ||
− | |||
[[Category:User Interface]] | [[Category:User Interface]] |
Latest revision as of 07:56, 9 September 2024
Access Lists (ACL[Note 1]) are part of the system to control access to shared resources like Upwell structures and bookmarks.
Overview
An access list controls who has access to a shared resource. What permissions are set is handled by shared folders for bookmarks and profiles for Upwell structures. An Access List has one or more members who are assigned one of the roles.
Role
Members of an access list have one of the following roles:
- Admin - Can edit and delete the list. Can add and remove members (all roles). Can assign all roles.
- Caution: An admin can demote, block and remove themself.
- Manager - Can add members. Can remove members with the Member or Blocked role. Can assign the Member and Blocked role, but not to Admins or Managers.
- Caution: A manager can demote, block and remove themself.
- Member - Gains the permissions that are granted to the access list. Can not see the list in their Access List window and thus can not see who its members are.
- Blocked - Is effectively for shared bookmark folders or profiles "removed" from the list. It is used to exclude an entity that is added by a "higher" entity.
The Admin and Manager roles apply only to the access list itself. The permissions set on shared folders or in profiles count as having the Member role. However, as the Admin or Manager role needed to "see" the access list only admins and managers can assign access lists to shared folders or profiles provided they have the permission/corporation-role to do so.
Member
Members of an access list can be:
- Everyone (Can only have the Member role)
- Alliances (Can not be Admin or Manager)
- Corporations (Can not be Admin or Manager)
- Capsuleers
Access lists are governed by the most granular setting available:
- Alliance supersedes "Everyone"
- Corporation supersedes Alliance
- Capsuleer supersedes Corporation.
Built-in
There is one built-in access list with one (Admin) member, the corporation the capsuleer is part of. It is named for the corporation (e.g. the one for the NPC corporation Republic University is named Republic University.) and can not be modified. So while the corporation has the Admin role (In contradiction with the rule that corporations can not be Admin or Manager) it effectively only makes the list visible and usable for all members of the corporation.
Access Lists window
Access Lists are managed through the Access Lists window. The Access Lists window can be opened
- using the Neocom menu: Social > Access Lists
- using the Neocom short-cut icon: Access Lists [Note 2]
- using a hot-key (There is no default)
The Access Lists window has the following components:
- List of access lists
- Access list details of the selected access list
- Access list name
- Access list description
- Role icon bar
- List of members (tab)
- Access list log (tab)
- Add Everyone button
- Member search bar
Create
Access Lists are created through the "Create a New Access List" window which has the following fields:
- Access List Name - The name of the access list (Required)
- Caution: This name is only a label, duplicates are accepted with no warning!
- Access List Description - A description of the access list (Optional). The description shows at the top of the member list and as a tool-tip when hovering over the list name.
To create an access list:
- open the Access Lists window
- click the + New Access List button
- enter the name (Required)
- enter the description (Optional)
- click Create
This will create an access list with one member, the creator, with the Admin role.
Manage members
Members are managed via the Access Lists window. The left side of the window shows the available access lists. The right side shows the details of the selected access list. The details shown are: name of the list, description of the list, the member list, and the logs. All changes to an access list are logged. The log can be viewed by selecting the "Access List Logs" tab on the right side of the Access List window.
Add
Members are added to an access list with the Member role and can be added in several ways.
- Clicking the + Add Members button.
- Opens the Add Member window. The Add Member window has Search and All Contacts tabs and activates an Add Member button when one or more entities are selected. Using the button adds the selected entities to the selected Access List. The Search tab only finds eligible entities. Entities can also be dragged, either into the Access List Members tab of the selected Access List or on top of an access list name, adding the selected entities to that list.
- Using the Add Members option accessed by right-clicking the Access List name or by clicking the hamburger in the top right.
- Opens the Contacts window. The Contacts window has Contacts, Agents and Search tabs. The Agents tab is irrelevant as agents can not be members of an access list. The Search tab, by default, finds all types of entities but can be configured to only search characters or corporations etc. The Contacts window only supports dragging entities into the Access List Members tab of the selected access list or on top of an access list name, adding the selected entities to that list.
- Besides these methods, members can be added to an access list by dragging them from:
- a chat channel or chat channel member list.
- the Guests list in a station or player structure
- the portrait/icon from an info window
- Members can also be copied from one access list to another by dragging them on top of an access list name. Warning: This also copies the role.
Everyone
Everyone can only be added in one way. Clicking on the globe icon on the bottom right of the member list, adds everyone to the selected access list.
Change role
A member's role can be changed in several ways. Multiple members can be selected to change in one go.
- Drag members to the role icon bar on top of the member list
- Use the options in the member menu. This menu can be activated by right-clicking the member name or by clicking the hamburger in the top right.
- The menu shows only applicable options - The possible options are:
- Block Member
- Unblock Member
- Make Admin
- Make Manager
- Strangely enough, there is no option "Make Member". This is done by the options "Remove Admin Role" and "Remove Manager Role".
- Corporations and alliances can not be blocked or unblocked via the menu they must be dragged to the role icon bar.
- The menu shows only applicable options - The possible options are:
Remove
Members can be removed from an access list by the "Remove Member" option of the member menu. This menu can be activated by right-clicking the member name or by clicking the hamburger in the top right.
Search
The Access Lists window has a search function (top-right of the window). The function acts as a filter. It limits the visible list members to those that match the filter. It also grays out Access Lists, which have no members that match the filter. The function is not dynamic, it requires hitting the Enter key or clicking on the magnifying glass to activate.
Note: The entry field can be hidden. To make it visible again click on the magnifying glass or the << marker to the left of it.
Edit
An access list can be edited (name and description), through the option "Edit Access List" in the Access List menu. This menu can be activated by right-clicking the Access List name or by clicking the hamburger in the top right.
Delete
An access list can be deleted through the option "Delete Access List" in the Access List menu. This menu can be activated by right-clicking the Access List name or by clicking the hamburger in the top right.
Publish
Access lists can be "published" by dragging them into chat, a chat channel's MOTD), EVEmail, a character's biography or a corporation/alliance's description[Verify] creating a link. Clicking on the link opens a window[Note 3] that shows the Access List's name, description and the Admin(s), but not the Managers. This information is not dynamic i.e. it is a snapshot of the information as is on the creation of the link.
See also
- EVE Support: Access Lists
Notes
- ^ The game calls it "Access List" but the concept is commonly called "Access-control list". Thus the abbreviation "ACL".
- ^ The short-cut area is player configurable so the icon may or may not be there
- ^ The window opens in a size that shows only the list's name. It can be enlarged to show the other information.