UnityRenderStreaming/com.unity.renderstreaming/Documentation~/https.md

5.9 KiB

Configure Self-Signed Credentials for https

Prerequisites

Windows

This document is written assuming that the OS is Windows.

Chocolatey

Chocolatey is a package manager for Windows (like apt-get or yum but for Windows). Link to install Chocolatey: https://chocolatey.org/install

OpenSSL

OpenSSL is a robust, commercial-grade, and full-featured toolkit for the Transport Layer Security (TLS) and Secure Sockets Layer (SSL) protocols. Installation:

choco install openssl.light

Step 1: Create a Private Key

Run the command:

"C:\Program Files\OpenSSL\bin\openssl.exe" genrsa -des3 -out rootSSL.key 2048

Enter a Password:

Enter pass phrase for rootSSL.key:

Verify the Password:

Verifying - Enter pass phrase for rootSSL.key:

Step 2: Create a Certificate File

Run the command:

"C:\Program Files\OpenSSL\bin\openssl.exe" req -x509 -new -nodes -key rootSSL.key -sha256 -days 1024 -out rootSSL.pem

Enter the Password:

Enter pass phrase for rootSSL.key:

Enter your Country's 2-Letter Code:

Country Name (2 letter code) [AU]:CA

Enter the name of your state/province:

State or Province Name (full name) [Some-State]:Quebec

Enter the name of your locality (city):

Locality Name (eg, city) []:montreal

Enter the name of your organization:

Organization Name (eg, company) [Internet Widgits Pty Ltd]:Unity

Enter the name of your business unit within the organization:

Organizational Unit Name (eg, section) []:Verticals

Enter your computer's fully qualified domain name or your name:

Common Name (e.g. server FQDN or YOUR name) []:Tony

Enter your e-mail address:

Email Address []:anthonyma@unity3d.com

Step 3: Get Windows to Trust the Certificate Authority (CA)

  1. Search for and run Microsoft Management Console (mmc.exe)

    mmc.exe

  2. Go to File > Add/Remove Snap-in...

    Add/Remove Snap-in...

  3. Click on Certificates and then Add >

    Add/Remove Snap-in...

  4. Select Computer Account and then Next >

    Add/Remove Snap-in...

  5. Select Local computer (the computer this console is running on) and then Finish

    Add/Remove Snap-in...

  6. Select OK in the Add or Remove Snap-ins window

    Add/Remove Snap-in...

  7. Expand Console Root > Certificates (Local Computer) in the Console1 - [Console Root] window

    Add/Remove Snap-in...

  8. Select Trusted Root Certification Authorities then Right-Click on Certificates and select All Tasks > Import...

    Add/Remove Snap-in...

  9. Select Next in the Certificate Import Wizard window

    Add/Remove Snap-in...

  10. Browse to the location of the rootSSL.pem file created in Step 2 and then select Next.

    Add/Remove Snap-in...

  11. Select Place all certificates in the following store and ensure that Trusted Root Certification Authorities is the value in the Certificate store: field, and then select Next.

    Add/Remove Snap-in...

  12. Select Finish.

    Add/Remove Snap-in...

Step 4: Create a Local Domain Site

  1. Add 127.0.0.1 client-1.local to your C:\Windows\System32\drivers\etc\hosts file.

    # Copyright (c) 1993-2009 Microsoft Corp.
    #
    # This is a sample HOSTS file used by Microsoft TCP/IP for Windows.
    #
    # This file contains the mappings of IP addresses to host names. Each
    # entry should be kept on an individual line. The IP address should
    # be placed in the first column followed by the corresponding host name.
    # The IP address and the host name should be separated by at least one
    # space.
    #
    # Additionally, comments (such as these) may be inserted on individual
    # lines or following the machine name denoted by a '#' symbol.
    #
    # For example:
    #
    #      102.54.94.97     rhino.acme.com          # source server
    #       38.25.63.10     x.acme.com              # x client host
    
    # localhost name resolution is handled within DNS itself.
    #   127.0.0.1       localhost
    #   ::1             localhost
    
    127.0.0.1 client-1.local
    # End of section
    
    

Step 5: Create a Private Key (client-1.local.key) and Certificate Request (client-1.local.csr) for the New Domain

Execute this command ensuring the following fields are the same as the ones you used in Step 1: Create a Private Key:

  • C=CA (Country)
  • ST=Quebec (State)
  • L=montreal (Locale)
  • O=Unity (Organization)
  • OU=Verticals (Business Unit)
  • CN=Tony (Name)
  • emailAddress=anthonyma@unity3d.com (E-Mail)
"C:\Program Files\OpenSSL\bin\openssl.exe" req -new -sha256 -nodes -out client-1.local.csr -newkey rsa:2048 -keyout client-1.local.key -subj "/C=CA/ST=Quebec/L=montreal/O=Unity/OU=Verticals/CN=Tony/emailAddress=anthonyma@unity3d.com"

Step 6: Issue the New Certificate (client-1.local.crt)

Execute the command:

"C:\Program Files\OpenSSL\bin\openssl.exe" x509 -req -in client-1.local.csr -CA rootSSL.pem -CAkey rootSSL.key -CAcreateserial -out client-1.local.crt -days 500 -sha256 -extensions "authorityKeyIdentifier=keyid,issuer\n basicConstraints=CA:FALSE\n keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment\n  subjectAltName=DNS:client-1.local"

Enter the password:

Enter pass phrase for rootSSL.key:

Step 7: Run the webserver.exe

Execute the command:

.\webserver.exe -s -p 443 -k client-1.local.key  -c client-1.local.crt