Difference between revisions of "User:Evon R'al/Draft 2"

From EVE University Wiki
Jump to: navigation, search
m (Editing.)
m (Editing.)
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 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 bookmarks.
  
 
== Overview ==
 
== Overview ==
An access list controls who has access to a shared resource. The what part 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.
+
An access list controls <em>who</em> has access to a shared resource. The what part 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 ===
 
=== Role ===
Line 52: Line 52:
 
* enter the description (Optional)
 
* enter the description (Optional)
 
* click {{Button|Create}}
 
* click {{Button|Create}}
This will create an access list with one member, the creator with the Admin role.
+
This will create an access list with one member, the creator, with the Admin role.
  
 
== Manage members ==
 
== Manage members ==
 
Members are managed via the Access List window. The left side of the window shows the available access lists. The right side shows the details of the selected access list.
 
Members are managed via the Access List window. The left side of the window shows the available access lists. The right side shows the details of the selected access list.
All changes to the 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.
+
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 ===
WIP
+
Members are added to an access list with the Member role and can be added in several ways.
Members can be added in several ways.
 
  
 
* Clicking the {{Button|+ Add Members}} button.
 
* Clicking the {{Button|+ Add Members}} button.
** Uses the Add Member window.
+
: 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.
*** Has an {{Button|Add Member}} button activated when an entity is selected.
 
*** Does only find eligible entities.
 
 
* Using the Add Members option accessed by right-clicking the Access List name or by clicking the hamburger in the top right.
 
* Using the Add Members option accessed by right-clicking the Access List name or by clicking the hamburger in the top right.
** Uses the Contacts window.
+
: 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.
*** By default finds every type but can be configured to only search characters or corporations etc.
+
 
* Dragging from a chat channel or chat channel member list.
+
* Besides these methods, members can be added to an access list by dragging them from:
* Dragging from the Guests list in a station or player structure
+
** a chat channel or chat channel member list.
* Dragging the portrait/icon from an info window
+
** the Guests list in a station or player structure
* Dragging from an Access List(copy). Warning: This also copies the role.
+
** 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 ====
Line 94: Line 93:
  
 
=== Search ===
 
=== Search ===
 +
[[File:Access Lists window-Search bar.png|thumb|The member search bar.]]
 
The Access List 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.
 
The Access List 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 ==
 
== Edit ==
Line 103: Line 105:
  
 
== Publish ==
 
== 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 windows opens in a size that shows only the lists 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 on the creation of the link.
+
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 windows 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 on the creation of the link.
  
 
 
<!-- *************** Start old stuff, Need to be evaluated for reuse or deletion **************-->
 
<hr style="height: 1em;">
 
== Old stuff ==
 
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.
 
 
There is a search function so search for entries inside a given list.
 
 
As of 2022, there is no API endpoint for access lists.
 
 
<hr style="height: 1em;">
 
<!--******************** End old stuff *************************************-->
 
 
== See also ==
 
== See also ==
 
* EVE Support: [https://support.eveonline.com/hc/en-us/articles/208289645-Access-Lists Access Lists]
 
* EVE Support: [https://support.eveonline.com/hc/en-us/articles/208289645-Access-Lists Access Lists]
Line 124: Line 113:
 
<References group=Note />
 
<References group=Note />
  
 
<References />
 
  
 
<!--[[Category:User Interface]]-->
 
<!--[[Category:User Interface]]-->

Revision as of 12:02, 2 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. The what part 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. 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 the purpose of 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. For the permissions set on shared folders or in profiles, they count as having the Member role. However, as you need the Admin or Manager role to "see" the access list only admins and managers can assign access lists to shared folders or profiles provided that they have the permission/corporation-role to do so.

The Access Lists window.

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 List window. The Access Lists window can be opened

  • using the Neocom menu: Social > Access Lists
  • using the Neocom menu: corporation path?
  • using the Neocom short-cut icon: Accessgroups.pngAccess Lists [Note 2]
  • using a hot-key (There is no default)

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)
  • 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 List window
  • click the + New Access List button
  • enter the name (Required)
    • Caution: This name is only a label, duplicates are accepted with no warning!
  • 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 List window. The left side of the window shows the available access lists. The right side shows the details of the selected access list. 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.

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 List 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 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 windows opens in a size that shows only the list's name. It can be enlarged to show the other information.