Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 20 Next »

Contents

This page presents basic information about the UW Groups Service that will help you use it via its web browser interface or its programmable REST interface.

Overview

The UW Groups Service is a central location in which groups can be created, managed, and then reused in other services and applications. Groups can be created from various sources of group information and used in a wide variety of integrated services and applications, as illustrated in Figure 1.

Some groups are managed by individual people and teams for ad hoc purposes such as collaboration. Other groups are managed for more formal purposes by UW organizations or by institutional processes such as UW course enrollments or UW employee appointments.

This diversity of group information sources and varied application uses is enabled by a delegated model of management authority: any member of the UW community can use the service to manage groups under their authority and delegate that authority to others as needed.

You can access the UW Groups Service's web browser interface using your personal UW NetID; access using shared UW NetIDs (also known as supplemental accountis) is not supported.  Programmatic access to the REST interface requires client authentication using a certificate issued by the UW Services CA.

UW Group IDs

The Groups service uses a structured namespace for group identifiers, known as UW Group IDs, permitting UW people and organizations to create and manage groups independently.  Each group has a unique UW Group ID.  Systems and applications using UW Groups typically refer to groups using UW Group IDs.

UW Group IDs consist of lower-case letters (a-z), digits (0-9), dash ("-") and underscore ("_"). The underscore character is used to separate components of group IDs, much like slash ("/") or backslash ("\") is used in URLs or filenames.

If you want to create new group, you can do so if you have appropriate rights (see Access Controls below) on an existing group.  You can see what groups you administer using the "My groups" tab.  For example, if you have Admin or Create access to the "uw_pavesci_admin" group, you could create a group called "uw_pavesci_admin_fulltime".  You should choose a UW Group ID appropriate for the expected use of the group, bearing in mind that the group may be used by many people for a long time.

If you need to create a new space in the UW Groups Service for your organization, see the Home Groups page.

Group Memberships

In the Group service, individual groups may include members using several types of identifiers:

Type

Example

Comment

UW NetID

bob234

Any type of UW NetID may be used

Federated ID

bob456@example.edu

An ID from some non-UW source, in user@domain format

DNS name

sys789.org.washington.edu

Any DNS name, typically used for names in UW-issued X.509 certificates

UW Group ID

uw_org789_all_tmp

Any other UW Group ID

The Groups service does not guarantee that member entries are valid; for example it does not check to see whether an entered UW NetID or member group really exists.

Some systems and applications using the service may be limited in the types of members they can handle.  For example, the use of federated IDs for access control wouldn't apply in an application that only accepts UW NetIDs for signon.

When viewing group memberships, direct members are those members that are listed in a group's entry, directly; while effective members include all direct members, plus members of any groups listed as members, recursively.

Administrators, subgroup creators, and member managers are not automatically added as group members.

Access Controls

The UW Groups Service provides controls to manage who can create, update, and delete group information. All groups have these controls:

Control

Role Name

Purpose

Admin

Administrator

Permits any operation on the group, including deletion, creation, and update

Create

Subgroup creator

Permits groups to be created with Group IDs based on this group's ID

Update

Member manager

Permits adding and removing members of the group

Member View

Membership viewer

Permits restricting who can view a group's membership

Access control entries can have any of the types of identifiers that group memberships can have (UW NetID, UW Group ID, federated ID, cert/DNS name).

An organizational home group has an initial set of users with Admin control, as requested by the organization.  You have Admin access to your personal home group when it is created.  These controls can be modified at any time so you can control access as needed.

Changing access controls on a group affects only that group. It has no effect on controls in any other existing groups.

Further Reading

Now that you're familiar with the basics of the group service, you may want to explore the web browser interfaceusing your personal UW NetID.

For further reading on some of topics mentioned above refer to these pages:

UW Group Naming Plan
Synchronization with UW Windows Infrastructure
Groups Service Architecture Diagram
Automated Group Management for Organizations

  • No labels