Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Metadata for the Proxy is contained within the the CCC Central Metadata feed that contains metadata for many CCC system-wide services. You should add the following configuration to your college/district IdP's conf/metadata-providers.xml file, which will automatically keep checking (every few hours) whether there is an updated file to download, and if so, download it and keep a local "backing file" on your IdP.

...

As you can tell from the above, the CCC Central Metadata feed is available at:  http://saml.ccctcportal.org/metadata/ccc-metadata.xml. Note that part of the above configuration is verifying the "signature" on that metadata file , and to do that , you need to must create a new file in your IdP's credentials/ directory , a file named 'credentials/ccctc-md-cert.pem' with the following content:

...

 

Configure the Attributes

Minimum Required Attributes

Make sure you understand and have all the following attributes required attributes available.

Simple Name and the SAMLv2 name when sent in the SAMLv2 responseShort descriptionSample value(s)Description

eduPersonPrincipalName (EPPN)


urn:oid:1.3.6.1.4.1.5923.1.1.1.6

The primary federated identifier of a given user from a college/district IdP.

jsmith@college.edu

12345678@college.edu

 

EPPN has the syntax of an email address, but it should be considered a "globally unique federated identifier" rather than an email address. It is generally the most important attribute to be shared with federated services. Note that the value of EPPN does not have to match what the user fills in as their username when they login, and the user does not need to know what their EPPN is, as it is shared between the IdP and the service. It should be unique, rarely change, and not be reassigned to another person.

eduPersonAffiliation

urn:oid:1.3.6.1.4.1.5923.1.1.1.1

Role within the institution
  • staff
  • student
  • member

All of the roles a given person has within the college. This is the only attribute listed here that is intended to have multiple values. All the rest are expected to have a single value.

eduPersonPrimaryAffiliation

urn:oid:1.3.6.1.4.1.5923.1.1.1.5

Primary role at the institution
  • staff
  • student
  • faculty

Must be one of the values specified in eduPersonAffilliation. If the eduPersonAffiliation attribute has many values, the primary affiliation should reflect the role to be associated with services that differentiate based on this value (such as the CCC Portal).

uid

urn:oid:0.9.2342.19200300.100.1.1

UsernamejsmithThis is usually the value that the user fills in as their username when they login. If you are using AD, the usual attribute you want to use to populate uid is the sAMAccountName attribute.

givenName ..... urn:oid:2.5.4.42

First NameJane 

sn (surname) .... urn:oid:2.5.4.4

Last NameSmith 

displayName

urn:oid:2.16.840.1.113730.3.1.241

Full name to display

Jane Smith 

mail (email)

urn:oid:0.9.2342.19200300.100.1.3

Email Addressjane.smith@college.edu 

cccId

https://www.openccc.net/

saml/attributes/cccId

 

Unique id for a student within the CCC system The CCCID is a critical attribute for students. If not specified, but required for a portal or service action, the CCCID will be looked up via the EPPN. If no match is found, the action cannot be performed until the user creates a CCCID via the OpenCCC portlet.

cccMisCode

https://www.openccc.net/

saml/attributes/cccMisCode

The MIS code assigned to a college by the CCC. If a IdP is for the district, and represents multiple colleges, each with their own MIS code, the IdP could send the district MIS code as a default.

123Ideally, the college/district IdP could send the exact right MIS code for the given person authenticating. If the IdP is 1-to-1 with a specific college, that is easy. But if your IdP is at the district-level and covers multiple colleges, then you'd need to add an attribute to the directory to hold a given user's MIS code. See this document if you don't know your MIS code(s): CCC MIS codes

street

urn:oid:2.5.4.9

Street address303 Mulberry St.
 locality .... urn:oid:2.5.4.7CityMetropolis 
st .... urn:oid:2.5.4.8

State or Province name

CA 
postalCode .... urn:oid:2.5.4.17Postal or zip code12345 
homePhone .... urn:oid:0.9.2342.19200300.100.1.20Home Phone Number+1 212 555 1234 
mobile .... urn:oid:0.9.2342.19200300.100.1.41Mobile Phone Number+1 775 555 6789 
    

street

urn:oid:2.5.4.9

Street address

303 Mulberry St.

 
    
    
    
    
    

 

Release Attributes to Proxy Instances

...