Skip to content

Commit

Permalink
Update instructions after first on-boarding
Browse files Browse the repository at this point in the history
  • Loading branch information
markt-asf committed Oct 23, 2024
1 parent f7d57df commit c8044d6
Showing 1 changed file with 26 additions and 18 deletions.
44 changes: 26 additions & 18 deletions content/pages/code-signing-use.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,25 +24,33 @@ Whichever signing option you choose, you will need to complete four steps:

Adding a new release manager needs to be performed by the infrastructure team. Please open an <a href="https://issues.apache.org/jira/browse/INFRA">INFRA Jira ticket</a> and select code signing as the component.

When the infrastructure team creates your account you will receive TBD. Your username is your ASF email address.
When the infrastructure team creates your account you will receive an email to your ASF email address.
You will be asked for a user name and password.
Use your ASF email address as the user name (if you enter anything else it should be ignored and your ASF email used anyway).
Provide a secure password.
It is recommended that you enabled 2FA for your account (Dashboard -> manage 2FA).
Note: The 2FA you configure here for account access is not the same as the 2FA you are required to configure later in these instructions to use eSigner.

You should configure your account to use 2FA.
Note: This 2FA is separate to the 2FA you will need to configure to perform code signing.
You may be prompted to verify your account. It is not necessary to do this.

You will see a message saying you have been invited to enroll for eSigner for the given certificate.
You should click yes to accept the invitation.

### Step 2: Obtaining credentials for code signing

Whatever you need to sign and however you choose to sign it, you need to create 2FA credentials.
Whatever you need to sign and however you choose to sign it, you need to create 2FA credentials for eSigner.
You create these via the ssl.com web interface.
Depending on your chosen signing method, you will need either to configure 2FA using the QR code you create or make a note of the base 64 encoded secret code associated.
Depending on your chosen signing method, you will need either to configure 2FA using the QR code provided or make a note of the base 64 encoded secret code.

1. Log on to [ssl.com](https://www.ssl.com/).
1. TBD.
1. On your Dashboard, there should be a single certificate listed under esigner enrolled orders. Click on it to take you to the certificate page.
1. On the right-hand side you will see a prompt to set up a pin. Provide a pin and click "create PIN". You should be shown a QR code and a secret code. Note that the warning that the QR code wll only be shown once is incorrect. You can always view the QR code and secret code by providing your pin on this page.

### Step 3: Install the OS integration

#### None

If you use JSign 4.0, you can skip this step.
If you use JSign, you can skip this step.

#### Windows integration

Expand All @@ -59,22 +67,18 @@ If you use JSign 4.0, you can skip this step.

### Step 4: Configure your chosen signing tool

#### Signing Windows binaries on Windows using signtool.exe

TBD.

#### Signing on Windows binaries on Windows or Linux with JSign 4.0+ Ant task

1. Make the JSign JAR from [Maven Central](https://search.maven.org/artifact/net.jsign/jsign) available to Ant.
1. The eSigner specific properties for the JSign task in Ant should be as follows:

storetype="ESIGNER"
alias="d97c5110-c66a-4c0c-ac0c-1cd6af812ee6"
storepass="<ssl.com user name>|<ssl.com password>"
keypass="<ssl.com eSigner TOTP secret>"
tsaurl="http://ts.ssl.com"
tsmode="RFC3161"
alg="SHA256"
storetype=ESIGNER
alias=d97c5110-c66a-4c0c-ac0c-1cd6af812ee6
storepass=<ssl.com user name>|<ssl.com password>
keypass=<ssl.com eSigner TOTP secret>
tsaurl=http://ts.ssl.com
tsmode=RFC3161
alg=SHA256

#### Signing Windows binaries on Linux with JSign 4.0+

Expand All @@ -84,6 +88,10 @@ TBD.

jsign --storetype ESIGNER --alias d97c5110-c66a-4c0c-ac0c-1cd6af812ee6 --storepass "<ssl.com user name>|<ssl.com password>" --keypass "<ssl.com eSigner TOTP secret>" --tsaurl="http://ts.ssl.com" --tsmode RFC3161 --alg SHA256 application.exe

#### Signing Windows binaries on Windows using signtool.exe

TBD.

#### Other signing formats, tools and operating systems

See the ssl.com eSigner on-line help.

0 comments on commit c8044d6

Please sign in to comment.