Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions docs/portal/audit-trail.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
---
title: Audit Trail
description: View a detailed log of past actions performed on the UID2 Portal.
hide_table_of_contents: false
sidebar_position: 09
---

import Link from '@docusaurus/Link';

# Audit Trail

In the UID2 Portal, Admin users can access the **Audit Trail** page to view a detailed log of all past actions performed by or on behalf of the current participant. The table displays the action performed, the user who performed it, the time it was performed, and whether it succeeded. The Audit Trail table also supports sorting and searching.
2 changes: 1 addition & 1 deletion docs/portal/email-contacts.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Email contacts cannot log in to the UID2 Portal or modify the account. They only

## Accessing the Email Contacts Page

To access the Email Contacts page, go to the top right of the UID2 Portal user interface where your login ID is displayed. Click the down arrow and choose **Email Contacts**.
To access the Email Contacts page, go to the top right of the UID2 Portal user interface where your name is displayed. Click the down arrow and choose **Email Contacts**.

For an illustration, see [UID2 Portal Structure](portal-overview.md#uid2-portal-structure).

Expand Down
Binary file modified docs/portal/images/portal-uid2-overview.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/portal/participant-info.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ As part of requesting a UID2 Portal account, you must provide some information a

In the UID2 Portal, some of this information is displayed. When you have access, verify that the information is accurate.

To access the page, go to the top right of the UID2 Portal user interface where your login ID is displayed. Click the down arrow and choose **Participant Information**.
To access the page, go to the top right of the UID2 Portal user interface where your name is displayed. Click the down arrow and choose **Participant Information**.

For an illustration, see [UID2 Portal Structure](portal-overview.md#uid2-portal-structure).

Expand Down
2 changes: 1 addition & 1 deletion docs/portal/portal-getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ The following table includes details of the information you'll need, and a link

| Item | Details | Link to Instructions |
| :--- | :--- | :--- |
| Team member information | For each, provide the following:<br/>- First name<br/>- Last name<br/>- Email<br/>- Job function | [Team Members](team-members.md) |
| Team member information | For each, provide the following:<br/>- First name<br/>- Last name<br/>- Email<br/>- Job function<br/>- Role | [Team Members](team-members.md) |
| Email contact information | For each, provide the following:<br/>- Email group name<br/>- Email alias<br/>- Contact type | [Email Contacts](email-contacts.md) |

## Reset Password
Expand Down
8 changes: 6 additions & 2 deletions docs/portal/portal-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,7 @@ The UID2 Portal is your one-stop shop for setting up and configuring your UID2 a
| Configure permissions for individual sharing participants or groups of sharing participants.<br/>NOTE: Use of sharing requires an API key (see [API Keys](api-keys.md)) or client-side key pair (see [Client-Side Integration](client-side-integration.md)). Configure these values before setting up sharing permissions. | [Sharing Permissions](sharing-permissions.md) |
| Add team members who will have permission to manage your account. | [Team Members](team-members.md) |
| Set up designated email contacts who will be notified of news or updates. | [Email Contacts](email-contacts.md) |
| View a detailed log of all past actions performed by, or on behalf of, the current participant. | [Audit Trail](audit-trail.md) |

## Access the UID2 Portal

Expand All @@ -36,20 +37,23 @@ There are two main ways to access the pages, as shown in the following image:

![UID2 Portal Structure](images/portal-uid2-overview.png)

From the left sidebar, you can access the following pages relating to configuring your account:
Your participant name will be displayed at the top of the left sidebar. If your account has access to multiple participants, as shown in the example above, a dropdown menu will appear. You can use this menu to switch between participants in the portal.
Copy link
Contributor

@ashleysmithTTD ashleysmithTTD Oct 31, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe add somewhere like on the Team Members page an explicit sentence that explains how an account does get access to a new participant outside of their default one - that an Admin for a participant needs to add someone as one of the team members for that person to get access. Also this may be obvious, but when the admin adds them, they can add them with either Admin or Operations role to access to another participant - you can decide if it's obvious enough or not, I could go either way.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm a bit hesitant to add details around how to invite an existing user to a new participant because it should just be the same as adding a brand new user to a participant. I'm planning on merging as-is and we can discuss/address separately.

Copy link
Collaborator

@genwhittTTD genwhittTTD Nov 6, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@alex-yau-ttd @ashleysmithTTD looking over these mods and I'd definitely be in favor of a) defining the roles in the doc (update: just found that in the next file!), b) explaining how someone is assigned a role. It should be covered, I think.


Continuing down the left sidebar, you can access the following pages relating to configuring your account:

- Home: link to home page, always present.
- [Sharing Permissions](sharing-permissions.md)
- [API Keys](api-keys.md)
- [Client-Side Integration](client-side-integration.md)

From the link at the top right, your user ID and image are displayed. If you have a Gravatar image set up (see [https://gravatar.com/](https://gravatar.com/)), your image is displayed. If you don't have a Gravatar image, a default image is displayed.
From the link at the top right, your name is displayed.

From here, you can access the following pages relating to your personal account settings and your daily activities:

- [Participant Information](participant-info.md)
- [Manage Team Members](team-members.md)
- [Email Contacts](email-contacts.md)
- [Audit Trail](audit-trail.md) (Admin users only)
- Dark Mode: toggles dark mode on and off
- [Log Out](portal-getting-started.md#log-out)

Expand Down
22 changes: 13 additions & 9 deletions docs/portal/team-members.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ import Link from '@docusaurus/Link';

# Team Members

In the UID2 Portal, on the **Team Members** page, you can perform all activities relating to configuring individuals who you want to authorize for access to your account, including the following:
In the UID2 Portal, on the **Team Members** page, Admin users can perform all activities relating to configuring individuals who you want to authorize for access to your account, including the following:

- [Add a Team Member](#add-a-team-member)
- [Resend an Invitation to a Team Member](#resend-an-invitation-to-a-team-member)
Expand All @@ -18,17 +18,17 @@ In the UID2 Portal, on the **Team Members** page, you can perform all activities

## Accessing the Team Members Page

To access the Team Members page, go to the top right of the UID2 Portal user interface where your login ID is displayed. Click the down arrow and choose **Manage Team Members**.
To access the Team Members page, go to the top right of the UID2 Portal user interface where your name is displayed. Click the down arrow and choose **Manage Team Members**.

For an illustration, see [UID2 Portal Structure](portal-overview.md#uid2-portal-structure).

## Team Member Rights and Responsibilities
## User Roles

Each team member is an administrator for the account, and can perform all activities relating to managing your team and your account, including the following:
Each team member has one of two user roles: Admin or Operations. Admin users can perform all activities related to UID2 participation, as summarized in the [UID2 Portal Overview](portal-overview.md).

- Add, modify, or remove additional team members: see [Add a Team Member](#add-a-team-member)
- Add, modify, or remove email contacts: see [Email Contacts](email-contacts.md).
- Add or remove sharing relationships and sharing settings: see [Sharing Permissions](sharing-permissions.md).
Users with the Operations role can perform most of the same actions as Admin users. However, they cannot add, modify, or remove team members. Instead, they have read-only access to the **Manage Team Members** page.

User Roles can only be modified by users with the Admin role, by following: [Edit Information for a Team Member](#edit-information-for-a-team-member).

## Add a Team Member

Expand All @@ -37,11 +37,15 @@ To add a team member, complete the following steps:
1. Log in to your UID2 Portal account.
1. At the top right, click the down arrow and choose **Manage Team Members**.
1. Click **Add Team Member**.
1. Enter the first name, last name, email, and job function.
1. Enter the first name, last name, email, job function and role.
1. Click **Save Team Member**.

The team member is added to the list, with Pending status, and an invitation email is sent to the invited person.

:::note
Team members can be added to more than one participant. Team members that belong to multiple participants are able to switch between participants as shown in [UID2 Portal Structure](portal-overview.md#uid2-portal-structure).
:::

## Resend an Invitation to a Team Member

If you added a team member, you might need to resend the invitation. For example, perhaps the team member didn't receive the invitation or accidentally deleted it, or the invitation has expired.
Expand All @@ -56,7 +60,7 @@ To re-send the invitation for a team member, complete the following steps:

## Edit Information for a Team Member

You can update any of the values: First Name, Last Name, Email, or Job Function.
Admin users can update any of the values: First Name, Last Name, Email, Job Function, or Role.

To edit information for a team member, complete the following steps:

Expand Down
1 change: 1 addition & 0 deletions sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -66,6 +66,7 @@ const fullSidebar = [
'portal/participant-info',
'portal/team-members',
'portal/email-contacts',
'portal/audit-trail',
],
},

Expand Down