====== PKI ======
===== Public Key Infrastructure =====
Below you will find instructions on how to request certificates with popular web browsers as well as instructions for the use of this certificates. The instructions for certification shall relate to e-mail (S / MIME) certificates. However, the requirement of other types of certificates is designed largely similar. If you have suggestions for further instructions or additional questions, you can send an e-mail to [[support@gwdg.de?subject=Question(s) about certificate(s)&body=Ladies and gentlemen,%0A%0AI have the following question(s) about certificate(s):%0A%0A|support@gwdg.de]] or use the GWDG [[https://gwdg.de/en/support|support form]].
===== Application for personal email certificate... =====
In the future, you will receive new certificates via the GÉANT TCS. For information on specific application procedures, please contact your local participant service of your institution.
For user certificates for signing and/or optional encryption of e-mails, the application method is the [[#geant_tcs_pki|GÉANT TCS PKI]] in most cases the right way. In cooperation with your local participant service employee of your institution or RA, you create a user certificate.
Further information can also be found in the information provided under "[[#detailed_description_of_e-mail_encryption_with_x509_certificates|Detailed description of email encryption with X.509 certificates]]" GWDG news articles available to you.
==== ... from the GÉANT TCS PKI ====
To apply for an email certificate from the GÉANT TCS PKI, which is anchored in the DFN's GÉANT TCS PKI tenant, please follow the information below.
Click on the URL for the [[https://cm.harica.gr|HARICA Certificate Manager]]
Log in using SSO by clicking on the 'Academic Login' button and entering your work email address and the associated password from your home organization.
__**or**__
Register your work email address with a self-chosen password at this URL [[https://cm.harica.gr/Register|HARICA Certificate Manager Signup]]
After successful registration, the dashboard will be displayed. Please click the menu item **Email** on the left in the navigation.
Select the certificate type **Email-only** and go through the application steps. This certificate type is the current recommendation from DFN.
After the application has been submitted, a certificate file will be downloaded in the download folder of the web browser used.
Please refer to [[en:services:it_security:pki:start#universally_applicable_to_x509_certificates]] for the further processing of this file with the file extension .p12.
If you have any questions, please send an e-mail to [[support@gwdg.de?subject=Question about my personal email certificate&body=Ladies and gentlemen,%0A%0AI have the following question(s) about certificate(s): %0A%0A|support@gwdg.de]] or use the GWDG [[https://gwdg.de/en/support|support form]].
===== Detailed description of e-mail encryption with X.509 certificates =====
For further steps and detailed instructions on how to install and use the certificate (the file with the file extension .p12 in the download directory of the web browser used) in different e-mail clients, please read the following documents.
==== Universally applicable to X.509 certificates ====
- [[https://www.gwdg.de/documents/20182/27257/GN_1-2-2020_www.pdf#page=14|GWDG Nachrichten 1-2|20]] - Teil 2: Installation und Verteilung von Zertifikaten
- [[https://www.gwdg.de/documents/20182/27257/GN_3-2020_www.pdf#page=6|GWDG Nachrichten 3|20]] - Teil 3: Outlook-E-Mail-Anwendungen
- [[https://www.gwdg.de/documents/20182/27257/GN_7-8-2020_www.pdf#page=8|GWDG Nachrichten 7-8|20]] - Teil 4: Apple E-Mail-Anwendungen
- [[https://www.gwdg.de/documents/20182/27257/GN_11-2020_www.pdf#page=12|GWDG Nachrichten 11|20]] - Teil 5: Thunderbird, Notes und Mutt
- [[https://www.gwdg.de/documents/20182/27257/GN_5-2021_www.pdf#page=8|GWDG Nachrichten 5|21]] - Teil 6: Private Zertifikate mit der Volksverschlüsselung
(currently only in German)
===== Apply for server certificates... =====
==== ... from the GÉANT TCS PKI ====
To apply for a server certificate from the GÉANT TCS PKI, which is anchored in the DFN tenant of the GÉANT TCS PKI, please follow the information below.
Click on the URL for the [[https://cm.harica.gr|HARICA Certificate Manager]].
Log in using SSO by clicking the "Academic Login" button and providing your institutional email address and the associated password of your home organization.
__**or**__ if there are difficulties...
Register your work email address with a self-chosen password at this URL [[https://cm.harica.gr/Register|HARICA Certificate Manager Signup]].
After successful registration, the dashboard will be displayed. Please click on the menu item **Server** on the left in the navigation and go through the application steps.
For the server certificate type, you can choose between **Domain-only (DV)** or **For enterprises or organizations (OV)**.
After returning to the dashboard, the certificate application that is still waiting for processing and approval can be seen under the **Pending Certificates** section. Please click on the three vertical dots and select **Order details**. Please highlight the complete **Order details** information and copy and paste it as the email text into the email that is opened by clicking [[support@gwdg.de?subject=Please process and approve the following server certificate application&body=Dear Sir or Madam,%0A%0Aplease process and approve the following server certificate application:%0A%0A|on this link]].
After the issuance, the certificate can be downloaded in the dashboard under the section **Valid Certificates** by clicking on the hard drive icon with the downward arrow. In the dialog, please click once on the buttons **PEM** and **PEM bundle**.
The certificate can either be assembled using [[en:services:it_security:pki:start#important_openssl_commands|OpenSSL commands]] from the downloaded components or under Windows using the utility **pem2p12.exe**, which can be downloaded from the following [[https://www.harica.gr/en/Tools/PemToP12|HARICA page]].
For further processing of this file with the file extension .p12, please refer to [[en:services:it_security:pki:start#detailed_description_of_the_possible_uses_of_x509_certificates|this section]].
If you have any questions, please send an email to [[support@gwdg.de?subject=Question about the requested server certificate&body=Dear ladies and gentlemen,%0A%0AI have the following question(s) about the server certificate(s):%0A%0A|support@gwdg.de]] or use the [[https://www.gwdg.de/support|support form]] of GWDG.
==== Unix/OS X ====
Call OpenSSL with the following Parameters
Simple Bash script...
openssl req -newkey rsa:4096 -sha256 -keyout priv-key.pem -out certreq.pem
* Download createscr.sh script.
* Change flags with chmod 744 createcsr.sh
* Run script as follows ./createcsr.sh.
==== Windows ====
Simple PowerShell script...
openssl req -newkey rsa:4096 -sha256 -keyout priv-key.pem -out certreq.pem
Simple Batch script...
openssl req -newkey rsa:4096 -sha256 -keyout priv-key.pem -out certreq.pem
After that, proceed with the [[#select_a_registration_authority_ra|Select a Registration Authority (RA)]] and upload the Certificate Signing Request (CSR) file in the offered web form of your institution, that you can reach by clicking on "upload for Servers".
===== Apply for server certificate with OpenSSL.cnf =====
Call OpenSSL with the following Parameters
==== Unix/OS X ====
Simple Bash script...
openssl req -config example.cnf -newkey rsa:4096 -sha256 -nodes -keyout example.key -out example-csr.pem
* Download createscr.sh script.
* Change flags with chmod 744 createcsr.sh
* Run script as follows ./createcsr.sh.
==== Windows ====
Simple PowerShell script...
openssl req -config example.cnf -newkey rsa:4096 -sha256 -nodes -keyout example.key -out example-csr.pem
Simple Batch script...
openssl req -config example.cnf -newkey rsa:4096 -sha256 -nodes -keyout example.key -out example-csr.pem
After that, proceed with the [[#select_a_registration_authority_ra|Select a Registration Authority (RA)]] and upload the Certificate Signing Request (CSR) file in the offered web form of your institution, that you can reach by clicking on "upload for Servers".
===== Sample files for OpenSSL.cnf =====
==== MPG ====
Please replace the word **example** with the server name and the email address **noreplay@{MPG | uni-goettingen | gwdg}.de** with a valid.
HOME = .
RANDFILE = $ENV::HOME/.rnd
####################################################################
[ req ]
default_bits = 4096
default_keyfile = example.key
distinguished_name = server_distinguished_name
req_extensions = server_req_extensions
string_mask = utf8only
####################################################################
[ server_distinguished_name ]
countryName = Country Name (2 letter code)
countryName_default = DE
stateOrProvinceName = State or Province Name (full name)
stateOrProvinceName_default = Niedersachsen
localityName = Locality Name (eg, city)
localityName_default = Goettingen
organizationName = Organization Name (eg, company)
organizationName_default = Max-Planck-Gesellschaft
# The name of your CA subordinate RA can be found here
# https://info.gwdg.de/docs/doku.php?id=de:services:it_security:pki:mpgras
# and thus, replace the value PKI
organizationalUnitName = Organizational Unit Name (eg, your Max-Planck-Institute)
organizationalUnitName_default = PKI
commonName = Common Name (eg, server FQDN or YOUR name)
commonName_default = example.mpg.de
emailAddress = Email Address
emailAddress_default = noreply@mpg.de
####################################################################
[ server_req_extensions ]
subjectKeyIdentifier = hash
basicConstraints = CA:FALSE
keyUsage = digitalSignature, keyEncipherment
subjectAltName = @alternate_names
nsComment = "OpenSSL Generated Certificate"
####################################################################
[ alternate_names ]
DNS.1 = example-san-1.mpg.de
DNS.2 = example-san-2.mpg.de
==== Uni Göttingen ====
Please replace the word **example** with the server name and the email address **noreplay@{MPG | uni-goettingen | gwdg}.de** with a valid.
HOME = .
RANDFILE = $ENV::HOME/.rnd
####################################################################
[ req ]
default_bits = 4096
default_keyfile = example.key
distinguished_name = server_distinguished_name
req_extensions = server_req_extensions
string_mask = utf8only
####################################################################
[ server_distinguished_name ]
countryName = Country Name (2 letter code)
countryName_default = DE
stateOrProvinceName = State or Province Name (full name)
stateOrProvinceName_default = Niedersachsen
localityName = Locality Name (eg, city)
localityName_default = Goettingen
organizationName = Organization Name (eg, company)
organizationName_default = Georg-August-Universitaet Goettingen
# Please remove the comment character for the next two lines. The name of the CA child RA
# You can see https://info.gwdg.de/docs/doku.php?id=de:services:it_security:pki:uniras here and thus replace the value PKI.
#organizationalUnitName = Organizational Unit Name (eg, your Institute name in the Uni-Goettingen-CA)
#organizationalUnitName_default = PKI
commonName = Common Name (e.g. server FQDN or YOUR name)
commonName_default = example.uni-goettingen.de
emailAddress = Email Address
emailAddress_default = noreply@uni-goettingen.de
####################################################################
[ server_req_extensions ]
subjectKeyIdentifier = hash
basicConstraints = CA:FALSE
keyUsage = digitalSignature, keyEncipherment
subjectAltName = @alternate_names
nsComment = "OpenSSL Generated Certificate"
####################################################################
[ alternate_names ]
DNS.1 = example-san-1.uni-goettingen.de
DNS.2 = example-san-2.uni-goettingen.de
==== GWDG ====
Please replace the word **example** with the server name and the email address **noreplay@{MPG | uni-goettingen | gwdg}.de** with a valid.
HOME = .
RANDFILE = $ENV::HOME/.rnd
####################################################################
[ req ]
default_bits = 4096
default_keyfile = example.key
distinguished_name = server_distinguished_name
req_extensions = server_req_extensions
string_mask = utf8only
####################################################################
[ server_distinguished_name ]
countryName = Country Name (2 letter code)
countryName_default = DE
stateOrProvinceName = State or Province Name (full name)
stateOrProvinceName_default = NIEDERSACHSEN
localityName = Locality Name (eg, city)
localityName_default = GOETTINGEN
organizationName = Organization Name (eg, company)
organizationName_default = Gesellschaft fuer wissenschaftliche Datenverarbeitung
# Please remove the comment character for the next two lines. The name of the CA child RA
# You can https://info.gwdg.de/docs/doku.php?id=de:services:it_security:pki:gwdgras here and replace the value PKI.
#organizationalUnitName = Organizational Unit Name (eg, your Institute name in the Uni-Goettingen-CA)
#organizationalUnitName_default = PKI
commonName = Common Name (e.g. server FQDN or YOUR name)
commonName_default = example.gwdg.de
emailAddress = Email Address
emailAddress_default = noreply@gwdg.de
####################################################################
[ server_req_extensions ]
subjectKeyIdentifier = hash
basicConstraints = CA:FALSE
keyUsage = digitalSignature, keyEncipherment
subjectAltName = @alternate_names
nsComment = "OpenSSL Generated Certificate"
####################################################################
[ alternate_names ]
DNS.1 = example-san-1.gwdg.de
DNS.2 = example-san-2.gwdg.de
===== Important OpenSSL commands =====
A collection of important OpenSSL commands for server certificates
==== Password removal from private key ====
openssl rsa -in example.key -out example.np.key
==== Creating a PKCS # 12 file from private and public keys ====
openssl pkcs12 -export -out example.pfx -inkey example.key -in example.pem
===== Detailed description of the possible uses of X.509 certificates =====
- [[https://www.gwdg.de/documents/20182/27257/GN_9-10-2020_www.pdf#page=10|GWDG Nachrichten 09-10|20]] - Teil 1: Serverzertifikate
(currently only in German)