Difference between revisions of "Access Lists"

From EVE University Wiki
Jump to: navigation, search
m (Edit the intro. Add link. Make link working.)
m (Rephrase.)
 
(4 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''Access Lists''' ('''ACL''')<ref>The game calls it "Access List" but the concept is commonly called "[https://en.wikipedia.org/wiki/Access-control_list Access-control list]". Thus the abbreviation "ACL".</ref>, are lists that allow players to control access to a shared resource. They are used for [[Upwell structures]] and [[Bookmarks|shared bookmarks]].
+
'''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.
  
The Access lists window is found in [[Neocom]] -> Social -> Access Lists.
+
== 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.
  
== Configuring access list ==
+
=== 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.
  
To create a new access list click the "+ New Access List" button at bottom left corner of the window.
+
[[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.
 +
}}
  
To edit access list select it on the left side panel.
+
Access lists are governed by the most granular setting available:
 +
* Alliance supersedes "Everyone"
 +
* Corporation supersedes Alliance
 +
* Capsuleer supersedes Corporation.
  
You can add pilots, corporations, or alliances by dragging them to the list. Alternatively you can use the "+ Add members" button to add new members from search results.
+
=== Built-in ===
There is also a special "Add everyone" button on bottom right corner. Having this "everyone" member is exactly what it says. It effectively adds everyone to the list.
+
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.
  
Entries in the list are of four different kinds: admin, manager, member, and blocked. Admins can change every aspect of the list. Managers are able to see the list in their ACL window and thus can see the entries. Further, they can add member and blocked entries. Members gain the access rights which are granted to an ACL but cannot explicitly see if they are part of an ACL. Blocked entries explicitly don't get access which is useful to create exceptions to the everyone entry but can also be used to create exceptions when you added corporations or alliances. The everyone entry can only have the member status.
+
=== 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)
  
You can share lists through drag and drop into chat channels or [[EVE Mail]]. This way you can use ACLs created by others. Such links provide you with basic information about the ACL: its name, description, and all its admins but not managers.
+
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
  
There is a search function so search for entries inside a given list.
+
== 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.
  
As of 2022, there is no API endpoint for access lists.
+
== 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 ==
* [https://support.eveonline.com/hc/en-us/articles/208289645-Access-Lists Helpdesk: Access Lists]
+
* EVE Support: [https://support.eveonline.com/hc/en-us/articles/208289645-Access-Lists Access Lists]
 +
 
 +
== Notes ==
 +
<References group=Note />
  
== Notes and references ==
 
{{Reflist}}
 
  
 
[[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.

The Access Lists window.
(1) List of access lists, (2) Access list details, (3) Add Everyone button, (4) Member 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

25 August 2024: Despite 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: Accessgroups.pngAccess Lists [Note 2]
  • using a hot-key (There is no default)

The Access Lists window has the following components:

  1. List of access lists
  2. 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)
  3. Add Everyone button
  4. 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.
The Create a New Access List window.

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

Add Members window

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.

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

The member search bar.

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

Notes

  1. ^ The game calls it "Access List" but the concept is commonly called "Access-control list". Thus the abbreviation "ACL".
  2. ^ The short-cut area is player configurable so the icon may or may not be there
  3. ^ The window opens in a size that shows only the list's name. It can be enlarged to show the other information.