Differenze tra le versioni di "IDEMRegistry"

Da WIKI IDEM GARR.
Jump to navigation Jump to search
Riga 160: Riga 160:
 
#*Selezionare dal menù a tendina ogni attributo richiesto dal SP e premere il bottone "'''Add'''"
 
#*Selezionare dal menù a tendina ogni attributo richiesto dal SP e premere il bottone "'''Add'''"
 
#*per ogni attributo specificare tramite tendina il parametro ''required'' se l'attributo è obbligatorio o ''desired'' se l'attributo è opzionale
 
#*per ogni attributo specificare tramite tendina il parametro ''required'' se l'attributo è obbligatorio o ''desired'' se l'attributo è opzionale
 +
 +
<br />
 +
==Service Provider Metadata management==
 +
 +
===How to register a new Service Provider on IDEM Entity Registry===
 +
 +
#From the Home Page open [https://registry.idem.garr.it/rr3/providers/sp_registration Insert a New Service Provider into the IDEM Test Federation]
 +
#On the next window paste the service metadata XML generated by its installation.
 +
#On the next window fill the tabs by following the table below:
 +
 +
{| class="wikitable"
 +
!General
 +
!Organization
 +
!Contacts
 +
!UI Information
 +
!UI Hints
 +
!SAML
 +
!Certificates
 +
!Required Attributes
 +
|-
 +
|Select '''IDEM Test Federation'''
 +
and insert your own email '''e-mail'''
 +
|Fill, at least for the english language, the fields:
 +
 +
*'''Name of organization,'''
 +
*'''Displayname of organization,'''
 +
*'''URL to information about organization'''
 +
|Add at least a '''technical''<nowiki/>' contact by pressing on the '''Add Contact''' button with an '''impersonal''' email address
 +
|Fill, at least for the english language, the fields:
 +
 +
*'''Name of organization,'''
 +
*'''Description of user community serviced,'''
 +
*'''URL to information about the Identity Provider,'''
 +
*'''URL to Privacy Policy of the Identity Provider,'''
 +
*'''Logo of Service'''
 +
|optional
 +
|already filled by XML metadata imported
 +
|already filled
 +
|Select each attribute required by the SP and press on the botton "'''Add'''". Specidy if the attribute added is ''required'' o ''desired.''
 +
|}
 +
The complete description of the bold fields are explained on the paragraph [[Update Service Provider metadata already registered in the IDEM Entity Registry|Update Service Provider metadata registered in the IDEM Entity Registry]]
 +
 +
To complete the metadata registration, presso on the blu button '''"Register"''' available on the bottom right position on each tab.
 +
 +
===Update Service Provider metadata registered in the IDEM Entity Registry===
 +
 +
#Open the [https://registry.idem.garr.it/rr3/ IDEM Entity Registry] and log in with:
 +
##your IdP ('''Login via IDEM''') if your institution is a member of GARR Network
 +
##your Local Account requested to IDEM Help: [mailto:Idem-help@garr.it idem-help@garr.it] 
 +
#Search your SP under the tab named '''Service Provider'''
 +
#Enable changes to your SP metadata by pressing on the button: [[File:RR EditPencil.png|37px]] and by choosing '''Edit Provider''' from the Menù opened on the left column
 +
#On the "'''Organization'''" tab be sure to complete:
 +
#*'''Name of organization''': at least into the english language
 +
#*'''Displayname of organization''': at least into the english language
 +
#*'''URL to information about organization''': at least into the english language
 +
#On the tab "'''Contacts'''" be sure to complete:
 +
#*At least a contact of the type "technical" with an impersonal email address (add also the "mailto:" prefix)
 +
#On the tab "'''UI Information'''" be sure to complete:
 +
#*'''Name of the Service''': Name of the service you want to show on the IdP Login pages (at least into the english language)
 +
#*'''Description of the Service''': small description of the service offered
 +
#*'''URL to information about the Service''': page where users can find useful informations about the service
 +
#*'''URL to Privacy Policy of the Service''': page where users can find the Privacy Policy followed by the service
 +
#*'''Logo of Service''': 80x60 or different size that respect the same aspect-ratio
 +
#:<!-- These logos, by following what indicated by REFEDS, have to be:
 +
 +
- Be downloadable from an URL protected by HTTPS (with a valid certificate)
 +
 +
- Have the size of 80x60 px (or different as long as it respects the aspect-ratio)
 +
 +
- Have a transparent background (hopefully) -->
 +
#On the tab "'''SAML'''" is possible :
 +
#*Check and change the values of '''Assertion Consumer Service''', '''Artifact Resolution Service''', '''Single Logout Service, RequestInitiator Locations, Discovery Response Locations'''
 +
#*Check that "'''Supported protocol enumerations'''" value is only "<code>urn:oasis:names:tc:SAML:2.0:protocol</code>" (SAML v2)
 +
#*Control that the "'''Supported Name Identifiers'''" list contains all the SAML v2 NameID supported by the SP and that they are order opportunately. If not, order them by dragging them with the mouse.
 +
#On the tab '''"Certificates'''" it is possible to add a new certificate or to remove a previous expired one:
 +
#*Under the section '''SPSSODescriptor''' it is expected at least a valid certificate
 +
#**the button <u>"Remove certificate"</u> can be use to remove an existant certificate
 +
#**the button <u>"Add certificate for SPSSODescriptor"</u> can be use to add a new certificate
 +
#On the tab '''"Required Attributes"''':
 +
#*Select every attribute your SP requests to allow access to users and press the button "'''Add'''"
 +
#*For each attribute specify if it is ''required'' (if it is mandatory for the access) or ''desired'' (if it is optional for the access)
  
 
<br />
 
<br />

Versione delle 15:44, 15 gen 2021

L'IDEM Entity Registry e' l'applicazione web di gestione dei metadata delle entita' della Federazione IDEM. L'IDEM Entity Registry e' gestito dal Servizio IDEM GARR AAI e puo' essere utilizzato da tutti i membri della Federazione IDEM: https://registry.idem.garr.it

The IDEM Entity Registry is the web application used to manage the entities of the IDEM Federation. The IDEM Entity Registry is managed by the IDEM GARR AAI Service and can be used by all the IDEM Federation members: https://registry.idem.garr.it

Gestione Metadata di un Identity Provider

Registrazione di un Identity Provider via IDEM Entity Registry

  1. Dalla Home Page scegliere "Inserisci un Nuovo Identity Provider nella IDEM Test Federation"
  2. Nella schermata successiva incollare il frammento di metadata come prodotto dall'installazione dell'idp (ad es. in Shibboleth cercare il file idp-metadata.xml)
  3. Nella schermata successiva completare le varie schede come proposto nella tabella sottostante:
General Organization Contacts UI Information UI Hints SAML Certificates
Selezionare la IDEM Test Federation

ed inserire la propria e-mail

Completare in doppia lingua (IT e EN) le voci:
  • Name of organization,
  • Displayname of organization,
  • URL to information about organization
 Con il bottone Add Contact aggiungere almeno un

contatto di tipo Technical con indirizzo e-mail impersonale

Completare in doppia lingua (IT e EN) le voci:
  • Name of organization,
  • Description of user community serviced,
  • URL to information about the Identity Provider,
  • URL to Privacy Policy of the Identity Provider,
  • Logo of Service
 facoltativo già completo già completo

La descrizione completa delle voci evidenziate in grassetto è disponibile qui sotto nel paragrafo Aggiornamento dei metadata di IdP già registrato in IDEM Entity Registry

Per concludere l'inserimento dei metadata premere il bottone blu "Register" disponibile in basso a destra in ciascuna delle schede.

Aggiornamento dei metadata di IdP già registrato in IDEM Entity Registry

  1. Accedere a IDEM Entity Registry seguendo Login via IDEM e appena entrati cercare il proprio idp nella scheda Identity Provider
  2. Entrare in modalità di modifica premendo sul bottone: RR EditPencil.png e scegliere Edit Provider dal Menù che si sarà aperto nella colonna a sinistra
  3. Nella scheda "Organization" completare:
    • Name of organization: Nome dell'organizzazione in Italiano e in Inglese
    • Displayname of organization: Nome dell'organizzazione da mostrare sui Discovery Service in Italiano e in Inglese
    • URL to information about organization: URL del sito web dell'organizzazione in italiano e in inglese
  4. Nella scheda "Contacts" completare:
    • Almeno un contatto di tipo Technical con indirizzo email impersonale (compreso del prefisso "mailto:")
  5. Nella scheda "UI Information" completare:
    • Name of organization: Nome dell'organizzazione come apparirà nel Discovery Service in Italiano e in Inglese
    • Description of user community serviced: Descrizione della comunità di utenti autorizzati ad utilizzare l'IdP
    • URL to information about the Identity Provider: pagina informativa per gli utenti
    • URL to Privacy Policy of the Identity Provider: Privacy Policy relativa al rilascio attributi da parte dell'IdP
    • Logo of Service: Logo dell'organizzazione visualizzato sui Discovery Service
  6. Nella scheda "SAML" è possibile :
    • Controllare i valori di SingleSignOn Service endpoints, Single Logout Service endpoints, Artifact Resolution Service endpoints, AttributeAuthorityDescriptor
    • Controllare che "Supported protocol enumerations" sia valorizzato al solo "urn:oasis:names:tc:SAML:2.0:protocol" (SAML v2) (sia per IDPSSODescriptor che per AttributeAuthorityDescriptor)
    • Che nella lista di "Supported Name Identifiers" siano spuntati tutti gli identificatori (SAML v2) supportati dal proprio IdP (sia per IDPSSODescriptor che per AttributeAuthorityDescriptor)
    • Modificare il valore "Scope" ed eventualmente aggiungere più valori se necessario (sia per IDPSSODescriptor che per AttributeAuthorityDescriptor)
  7. Nella scheda "Certificates" è possibile aggiungere un nuovo certificato e rimuovere un precedente certificato scaduto:
    • sezione IDPSSODescriptor: obbligatorio almeno 1 certificato valido
      • bottone "Remove certificate" per eliminare un certificato esistente, bottone "Add certificate for IDPSSODescriptor" per aggiungerne uno nuovo
    • sezione AttributeAuthorityDescriptor: obbligatorio almeno 1 certificato valido
      • bottone "Remove certificate" per eliminare un certificato esistente, bottone "Add certificate for AttributeAuthorityDescriptor" per aggiungerne uno nuovo

Gestione Metadata di un Service Provider

Registrazione di un Service Provider via IDEM Entity Registry

  1. Dalla Home Page scegliere Inserisci un Nuovo Service Provider nella IDEM Test Federation
  2. Nella schermata successiva incollare il frammento di metadata come prodotto dall'installazione del SP.
  3. Nella schermata successiva completare le varie schede come proposto nella tabella sottostante:
General Organization Contacts UI Information UI Hints SAML Certificates Required Attributes
Selezionare la IDEM Test Federation

ed inserire la propria e-mail

Completare in doppia lingua (IT e EN) le voci:
  • Name of organization,
  • Displayname of organization,
  • URL to information about organization
 Con il bottone Add Contact aggiungere almeno un contatto

di tipo Technical con indirizzo e-mail impersonale

Completare in doppia lingua (IT e EN) le voci:
  • Name of organization,
  • Description of user community serviced,
  • URL to information about the Identity Provider,
  • URL to Privacy Policy of the Identity Provider,
  • Logo of Service
 facoltativo già completo già completo Selezionare dal menù a tendina ogni attributo richiesto dal SP e premere il bottone "Add", specificare poi tramite tendina il parametro required o desired

La descrizione completa delle voci evidenziate in grassetto è disponibile qui sotto nel paragrafo Aggiornamento dei metadata di SP già registrato in IDEM Entity Registry

Per concludere l'inserimento dei metadata premere il bottone blu "Register" disponibile in basso a destra in ciascuna delle schede.


Aggiornamento dei metadata di SP già registrato in IDEM Entity Registry

  1. Accedere a IDEM Entity Registry seguendo Login via IDEM e appena entrati cercare il proprio sp nella scheda Service Provider
  2. Entrare in modalità di modifica premendo sul bottone: RR EditPencil.png e scegliere Edit Provider dal Menù che si sarà aperto nella colonna a sinistra
  3. Nella scheda "Organization" completare:
    • Name of organization: Nome dell'organizzazione in Italiano e in Inglese
    • Displayname of organization: Nome dell'organizzazione che offre la risorsa (in Italiano e in Inglese)
    • URL to information about organization: URL del sito web dell'organizzazione (in italiano e in inglese)
  4. Nella scheda "Contacts" completare:
    • Almeno un contatto di tipo Technical con indirizzo email impersonale (compreso del prefisso "mailto:")
  5. Nella scheda "UI Information" completare:
    • Name of the Service: Nome dell'organizzazione come apparirà nel Discovery Service in Italiano e in Inglese
    • Description of the Service: Breve descrizione del servizio offerto
    • URL to information about the Service: Pagina informativa per gli utenti
    • URL to Privacy Policy of the Service: Privacy Policy relativa al Service Provider
    • Logo of Service: Logo del servizio visualizzato sulle pagine di login degli Identity Provider
  6. Nella scheda "SAML" è possibile :
    • Controllare e modificare i valori degli endpoint Assertion Consumer Service, Artifact Resolution Service, Single Logout Service, RequestInitiator Locations, Discovery Response Locations
    • Controllare che "Supported protocol enumerations" sia valorizzato al solo "urn:oasis:names:tc:SAML:2.0:protocol" (SAML v2)
    • Controllare che nella lista "Supported Name Identifiers" siano spuntati tutti gli identificatori (SAML v2) richiesti dal SP e ordinati opportunamente (per ordinare trascinare con il mouse)
  7. Nella scheda "Certificates" è possibile aggiungere un nuovo certificato e rimuovere un precedente certificato scaduto:
    • sezione SPSSODescriptor: obbligatorio almeno 1 certificato valido
      • bottone "Remove certificate" per eliminare un certificato esistente, bottone "Add certificate for SPSSODescriptor" per aggiungerne uno nuovo
  8. Nella scheda "Required Attributes":
    • Selezionare dal menù a tendina ogni attributo richiesto dal SP e premere il bottone "Add"
    • per ogni attributo specificare tramite tendina il parametro required se l'attributo è obbligatorio o desired se l'attributo è opzionale


Service Provider Metadata management

How to register a new Service Provider on IDEM Entity Registry

  1. From the Home Page open Insert a New Service Provider into the IDEM Test Federation
  2. On the next window paste the service metadata XML generated by its installation.
  3. On the next window fill the tabs by following the table below:
General Organization Contacts UI Information UI Hints SAML Certificates Required Attributes
Select IDEM Test Federation

and insert your own email e-mail

Fill, at least for the english language, the fields:
  • Name of organization,
  • Displayname of organization,
  • URL to information about organization
 Add at least a technical' contact by pressing on the Add Contact' button with an impersonal email address Fill, at least for the english language, the fields:
  • Name of organization,
  • Description of user community serviced,
  • URL to information about the Identity Provider,
  • URL to Privacy Policy of the Identity Provider,
  • Logo of Service
 optional already filled by XML metadata imported already filled Select each attribute required by the SP and press on the botton "Add". Specidy if the attribute added is required o desired.

The complete description of the bold fields are explained on the paragraph Update Service Provider metadata registered in the IDEM Entity Registry

To complete the metadata registration, presso on the blu button "Register" available on the bottom right position on each tab.

Update Service Provider metadata registered in the IDEM Entity Registry

  1. Open the IDEM Entity Registry and log in with:
    1. your IdP (Login via IDEM) if your institution is a member of GARR Network
    2. your Local Account requested to IDEM Help: idem-help@garr.it
  2. Search your SP under the tab named Service Provider
  3. Enable changes to your SP metadata by pressing on the button: RR EditPencil.png and by choosing Edit Provider from the Menù opened on the left column
  4. On the "Organization" tab be sure to complete:
    • Name of organization: at least into the english language
    • Displayname of organization: at least into the english language
    • URL to information about organization: at least into the english language
  5. On the tab "Contacts" be sure to complete:
    • At least a contact of the type "technical" with an impersonal email address (add also the "mailto:" prefix)
  6. On the tab "UI Information" be sure to complete:
    • Name of the Service: Name of the service you want to show on the IdP Login pages (at least into the english language)
    • Description of the Service: small description of the service offered
    • URL to information about the Service: page where users can find useful informations about the service
    • URL to Privacy Policy of the Service: page where users can find the Privacy Policy followed by the service
    • Logo of Service: 80x60 or different size that respect the same aspect-ratio
  7. On the tab "SAML" is possible :
    • Check and change the values of Assertion Consumer Service, Artifact Resolution Service, Single Logout Service, RequestInitiator Locations, Discovery Response Locations
    • Check that "Supported protocol enumerations" value is only "urn:oasis:names:tc:SAML:2.0:protocol" (SAML v2)
    • Control that the "Supported Name Identifiers" list contains all the SAML v2 NameID supported by the SP and that they are order opportunately. If not, order them by dragging them with the mouse.
  8. On the tab "Certificates" it is possible to add a new certificate or to remove a previous expired one:
    • Under the section SPSSODescriptor it is expected at least a valid certificate
      • the button "Remove certificate" can be use to remove an existant certificate
      • the button "Add certificate for SPSSODescriptor" can be use to add a new certificate
  9. On the tab "Required Attributes":
    • Select every attribute your SP requests to allow access to users and press the button "Add"
    • For each attribute specify if it is required (if it is mandatory for the access) or desired (if it is optional for the access)


Estratto da "https://wiki.idem.garr.it/w/index.php?title=IDEMRegistry&oldid=9253"