Seitenhistorie

...

• Was ist TCS?
• Was ist ein TCS-Admin?
• Was ist DCV?
• HARICA Support
• Was ist im TCS Portfolio enthalten

TCS Zusatzvereinbarung

• Informationen zu Beilage 1 (Nachweis der Rechtspersönlichkeit)
• Informationen zu Beilage 2 (Details zur Teilnehmerorganisation)
• Informationen zu Beilage 3 (Autorisierte Vertreter des Teilnehmers)

Admins im Harica Certificate Manager

RAOs

• Anlegen der initialen Admins
• Anlegen weiterer Admins

Validierung der Organisation

• Organisationsvalidierung beantragen
• notwendige Dokumentation
• Änderung des Organisationsnamen

Management von Domains

• Anlegen von Domains
• Validieren von Domains
• Re-Validierung von Domains
• Löschen von Domains

...

• Zertifikatstypen
• Self Enrollment
• SAML Self Service Portal

Code Signing Zertifikate

Grid bzw. IGTF SSL Zertifikate

ACME Verwendung

• Enterprise Accounts
• Personal Accounts

API Verwendung

...

Allgemein

Anker
tcs tcs

Was ist TCS?

...

Der HARICA Support steht allen Teilnehmern unter support-tcs@harica.gr zur Verfügung.

Anker
portfolio portfolio

Was ist im TCS Portfolio enthalten

Im TCS Portfolio sind die folgenden Zertifikatstypen enthalten:

• DV Server Zertifikate
• OV Server Zertifikate
• E-Mail only S/MIME Zertifikate (Mailbox‐validated)
• Individual & Organisation S/MIME Zertifikate (Sponsor‐validated)

Für alle anderen Zertifikatstypen gelten die im Portal angezeigten Preise..

TCS Zusatzvereinbarung

Die TCS-Zusatzvereinbarung ist in der aktuell gültigen Version unter https://www.aco.net/tcs.html zu finden.

...

1. Sie schicken uns eine weitere, ausgefüllte und unterschrieben Beilage 3 der TCS-Zusatzvereinbarung (https://www.aco.net/tcs.html) mit den neuen Admins. Hier genügt eine elektronische Version per Mail an tcs@aco.net.
2. Ein bestehender TCS Admin schickt uns per Mail die notwendigen Informationen (wie in Beilage 3) zum Anlegen eines weiteren Admins per Mail an tcs@aco.net.
3. Ein bestehender Admin berechtigt einen neuen Account selbst (siehe Enterprise Admin Guide Abschnitt B - 'Assign Enterprise Admin and Enterprise Approver Roles'.

Validierung der Organisation

Anker
ov_apply ov_apply

Organisationsvalidierung beantragen

Um ihre Organisation zu validieren, gehen sie wie folgt vor:

Im Harica Certificate Manager wählen sie dazu 'Enterprise' - 'Admin' und klicken auf die dort angezeigte Organisation. Es geht dann ein zusätzliches 'Fenster' auf, wo sie den Tab 'Enterprises' und 'Domains' sehen. Ein Klick auf z.B. den Legal Name der Organisation im 'Enterprises' Tab öffnet die Detailansicht der Organisation.
Durch Klicken auf das Symbol 'Datei' oben rechts gelangen Sie zu einem Dialog, in dem Sie die entsprechenden Dokumente hochladen können.
Detailierte Informationen entnehmen sie bitte dem Enterprise Admin Guide Abschnitt E - 'Submit Legal Evidence for Identity Validation' .

Anker
ov_docs ov_docs

notwendige Dokumentation

Harica ist bemüht die Validierungen von Organisationen so einfach wie möglich zu gestalten.
Ausgangspunkt der Validierung sind entsprechende Dokumente, die die rechtmäßige Existenz der Organisation belegen.

Beispiele dafür:

• Firmenbuchauszug
• Vereinsregisterauszug
• entsprechendes Gesetz, z.B. Universitätsgesetz, Bundesministeriengesetz
• Legal Entity Identifier (LEI)
• Ergänzungsregister

Sollte nichts davon möglich sein beginnen sie mit einer einfachen Textdatei, in der sie die rechtmäßige Existenz der Organisation beschreiben. Harica wird dann versuchen entsprechende Dokumentation zu finden. Ist das nicht möglich werden sie von Harica kontaktiert, um gemeinsam eine Lösung zu finden.
Bei Problemen stehen wir ihnen natürlich auch hier unter tcs@aco.net hilfreich zur Seite.

Anker
ov_change ov_change

Änderung des Organisationsnamen

Sollte eine Änderung des Organisationsnamen nötig sein, so ist das nur über den HARICA Support möglich. Eine Änderung ist an zwei Stellen nötig:

1. Änderung des 'Enterprise Alias' - dazu ein Mail mit den gewünschten Änderungen an den HARICA Support senden.
2. Änderung des Organisationsnamen ('O=...' im Zertifikat) für die Validierung - dazu eine neue Validierung mit entsprechender Dokumentation anstossen.

Management von Domains

Anker
create_domain create_domain

Anlegen von Domains

Bevor sie Zertifikate beantragen können, müssen sie die entsprechenden Domains angelegt und validiert haben.

Im Harica Certificate Manager wählen sie dazu 'Enterprise' - 'Admin' und klicken auf die dort angezeigte Organisation. Es geht dann ein zusätzliches 'Fenster' auf, wo sie den Tab 'Enterprises' und 'Domains' sehen. Ein Klick auf z.B. den Legal Name der Organisation im 'Enterprises' Tab öffnet die Detailansicht der Organisation.
Mit einem Klick auf das Globus-Symbol oben rechts gelangen Sie zu einem Dialog, mit dem Sie neue Domänen anlegen können.

Die anzulegenden Domains können nur mittels Textfile (CSV) hochgeladen werden. Sie können sich auf der Seite eine Beispieldatei herunterladen, das Format ist aber sehr simpel:

Domain
domain1.ac.at
domain2.at
domain3.gv.at
usw.

Anker
validate_domain validate_domain

Validieren von Domains

Starten der Validierung:

Klicken sie unter 'Enterprise' auf 'Admin' um in die Organisations-Administration zu gelangen. Dann wählen sie auf den Button ihre Organisation und im Reiter 'Domains' klicken sie auf 'Validate Domain' → Methode wählen → den Anweisungen folgen (zu den Methoden, siehe Was ist DCV?)neben der zu validierenden Domain.
Dann wählen sie den gewünschten 'Validation Type'.

Im Falle von  'Constructed Email to Domain Contact' wählen sie danach die gewünschte Email-Adresse und klicken Submit. Sie bekommen dann ein Email mit einem Validierungslink. Zu beachten ist , dass der Link im versendeten Email nur für jenen Account gilt, der die Validierung ausgelöst hat. Mit jedem anderen Account bekommen sie einen 404 Error.

Im Falle von 'DNS Change' wird ein Email mit dem im DNS einzutragenden TXT Record an die von ihnen angegebene Email-Adresse geschickt.

Anker
revalidate_domain revalidate_domain

Re-Validierung von Domains

...

Anker
cert_profiles cert_profiles

Zertifikatstypen

Im TCS Portfolio sind die folgenden Zertifikatstypen enthalten:

• DV Server Zertifikate
• OV Server Zertifikate
• E-Mail only S/MIME Zertifikate (Mailbox‐validated)
• Individual & Organisation S/MIME Zertifikate (Sponsor‐validated)

Für alle anderen Zertifikatstypen gelten die im Portal angezeigten Preise..

Anker
keypair keypair

Erstellen eines CSR (Certificate Signing Request)

...

Anker
EV EV

EV (Extended Validation) Zertifikate

...

Anker
cert_delivery cert_delivery

Empfang und Verwendung der Zertifikate

Die Zertifikate können unter 'My Dashboard' heruntergeladen werden. Dazu den 'download-Button' neben dem jeweiligen Zertifikat wählen, was folgenden Dialog öffnet:
Image Added

Am einfachsten ist es, das 'PEM bundle' zu verwenden, welches in der zur Verfügung gestellten Form ohne Änderungen am Webserver verwendet werden kann.

S/MIME (Email bzw. Client) Zertifikate

...

Anker
client_selfenroll client_selfenroll

Self Enrollment

tbd

Anker
SAML_SSP SAML_SSP

SAML Self Service

Harica betreibt kein spezielles SAML Self Service Portal

...

für S/MIME Zertifikate, sondern integriert die Funktionalität in den Harica Certificate Manager.

Um den Usern die Möglichkeit zu geben, Email-Zertifikate auszustellen, die sowohl individuelle als auch organisatorische Eigenschaften beinhalten (IV+OV bzw. Sponsor Validated (SV) S/MIME), muss diese Funktionalität erst aktiviert werden:
Im Harica Certificate Manager wählen sie dazu 'Enterprise' – 'Admin' und klicken auf die dort angezeigte Organisation. Es geht dann ein zusätzliches 'Fenster' auf, wo sie den Tab 'Enterprises' und 'Domains' sehen. Ein Klick auf z.B. den Legal Name der Organisation im 'Enterprises' Tab öffnet die Detailansicht der Organisation.
Dort sehen sie rechts oben das 'Brief' Symbol und nach einem Klick auf das Symbol öffnet sich ein Fenster in dem sie die Funktionalität aktivieren.

Image Added

Wenn sich nun ein User föderiert anmeldet ('Academic Login') und ein Email-Zertifikat ('For enterprises or organizations (IV+OV)' (ganz unten in der Auswahl)) beantragt, ist das Hochladen eines Ausweisdokuments nicht mehr notwendig und die entsprechenden Felder sind auf Grund der Attribute, die vom IdP übertragen werden, vorausgefüllt.
Zu beachten ist, dass aktuell – auch wenn mehrere Email-Adressen übertragen werden, nur die erste Email-Adressen für das Zertifikat verwendet wird. In Zukunft werden bis zu 3 Adressen erlaubt sein, wobei der User wählen kann, welche davon im Zertifikat verwendet werden sollen.

Im weiteren Verlauf können die Informationen nur bestätigt, aber nicht verändert werden. Nach Validierung der Gültigkeit der Email-Adresse (Bestätigungs-Email) gibt es im Dashboard einen neuen Abschnitt 'Ready Certificates'. Dort kann dann das tatsächliche Zertifikat mit einem Klick auf 'Enroll your Certificate' ausgestellt werden.

Folgende Attribute müssen vom IdP gesendet werden:

• givenName (oid:2.5.4.42)
• surname (oid:2.5.4.4)
• mail (oid:0.9.2342.19200300.100.1.3)
• edupersonTargetedID (oid:1.3.6.1.4.1.5923.1.1.1.10)
• eduPersonEntitlement  (oid:1.3.6.1.4.1.5923.1.1.1.7), mit einem der folgenden Werte:
  • urn:mace:terena.org:tcs:personal-user
    oder
  • urn:mace:terena.org:tcs:smime-sv-autoissue

  Im Profil des angemeldeten Users (Klick auf den Namen rechts oben) können unter 'View Login Information' die gesendeten Attribute angesehen werden.  tbd

Anker
cs cs

Code Signing Zertifikate

Voraussetzungen:

Beantragung Zertifikat:

Code Signing Zertifikate sind nicht im TCS Portfolio enthalten. CS Zertifikate können aber bei Harica zum angezeigten Preis erworben werden.

Anker
igtf igtf

Grid bzw. IGTF SSL Zertifikate

...

Anker
acme acme

ACME Verwendung

Aktuell ist ACME nur für DV Zertifikate verfügbar. Ausserdem ist es notwendig eine ACME-Challenge, HTTP-01 oder DNS-01, zu verwenden.

Die zu verwendende URL ist https://acme.harica.gr/TCS-DV/directory - für die Verwendung ist eine Key ID und ein HMAC Key nötig. Um diese zu erhalten kontaktieren sie bitte das ACOnet Team unter tcs@aco.net

Anker
acme_ea acme_ea

Enterprise Accounts

ACME Enterprise Accounts können nur von einem 'Enterprise Admin' erstellt werden. Diese Accounts verwenden ausschliesslich bereits validierte Domains, weshalb auch keine ACME-Challenges notwendig sind.
Weiters ist eine sehr granulare Einschränkung auf Domains und/oder Hostnamen, für die im jeweiligen Account Zertifikate ausgestellt werden können, möglich. Auch der Typ des Zertifikats, also OV oder DV, ist in der Konfiguration des Accounts möglich.

Zur Erstellung eines Account ist folgendermaßen vorzugehen:

Unter 'Enterprise' - 'Admin' findet sich der Tab 'ACME'
Image Added

Mit dem Button 'Create +' kann ein neuer Account hinzugefügt werden. Hier (falls mehrere verfügbar) die Organisation wählen, ebenso den Zertifikatstyp und einen Namen für den Account vergeben. Diese Auswahl kann nachträglich nicht mehr geändert werden.
An dieser Stelle kann noch keine Auswahl der verfügbaren Domains gemacht werden. Nach Zustimmung zu den Richtlinien kann der Account mit 'Create' erstellt werden.

Nach einem Klick auf den erstellten Account öffnet sich dessen Detailansicht:

Image Added

In dieser Ansicht sind neben den notwendigen Zugriffsdaten unter dem Tab 'Details', auch die ausgestellten Zertifikate unter dem Tab 'Certificates', sowie der Tab 'Domains' zur Konfiguration der verfügbaren bzw. erlaubten Domains ersichtlich.

Beispiele für die Verwendung des so erstellten Accounts:

certbot certonly --standalone --non-interactive --agree-tos --email <eigene Mailadresse> --eab-kid <Key ID> --eab-hmac-key <HMAC Key> --server <Server URL> --domain <FQDN des Zertifikats>

oder

lego --accept-tos --server <Server URL> --email <eigene Mailadresse> --domains <FQDN des Zertifikats> --eab --kid <Key ID> --hmac <HMAC Key> --http run

Anker
acme_pa acme_pa

Personal Accounts

Nur verfügbar wenn ein Enterprise Admin diese Funktion freischaltet, dann aber für alle dieser Enterprise zugeordneten User. Diese ACME Accounts müssen für die Ausstellung von Zertifikaten eine ACME-Challenge (DNS-01 oder HTTP-01) verwenden und es werden ausschliesslich DV Zertifikate ausgestellt.

Freischaltung der ACME Personal Accounts:

Im Harica Certificate Manager wählen sie dazu 'Enterprise' - 'Admin' und klicken auf die dort angezeigte Organisation. Es geht dann ein zusätzliches 'Fenster' auf, wo sie den Tab 'Enterprises' und 'Domains' sehen. Ein Klick auf z.B. den Legal Name der Organisation im 'Enterprises' Tab öffnet die Detailansicht der Organisation.

Dort sehen sie rechts oben das 'Tags' Symbol und nach einem Klick auf das Symbol öffnet sich ein Fenster in dem sie die Funktionalität '#ACME-Personal' aktivieren.

Image Added

Diese Einstellung bewirkt einen neuen Menüpunkt 'ACME' im Harica Certificate Manager:

Image Added

Hier können nun bis zu 3 ACME Accounts pro User erstellt werden.

Beispiel für die Verwendung des so erstellten Accounts:

certbot certonly --webroot --webroot-path /var/www --non-interactive --agree-tos --email <eigene Mailadresse> --eab-kid <Key ID> --eab-hmac-key <HMAC Key> --server <Server URL> --domain <FQDN des Zertifikats>

Die Angabe einer Mailadresse ist zwingend notwendig Eine erweiterte ACME Funktionalität, mit EAB und 'pre-validated' Domains ist voraussichtlich ab Anfang Q2/2025 verfügbar.

Anker
api api

API Verwendung

Infos zur verfügbaren API sind unter https://guides.harica.gr/docs/Guides/Developer/ und https://developer.harica.gr verfügbar.

Beispiele für die API Verwendung:

• Go

  • https://github.com/hm-edu/harica

• Java

  • https://poll.hs-kempten.de/harica/

• Perl

  • https://www.math.uni-bonn.de/people/ef/harica/

  • https://software.nikhef.nl/experimental/tcstools/tcsg5/

• PHP

  • https://www.uni-muenster.de/CA/harica-php.txt

• Python
  • https://github.com/utu/harica
  • https://github.com/ConsortiumGARR/tcs-garr