Skip to main content

Create a key and certificate

Your server proves its identity by signing requests with an RSA private key. Ryno only ever receives the matching public certificate. The private key never leaves your infrastructure.

Certificate requirements​

RequirementValue
Key typeRSA, 2048 bits or more. EC keys are not accepted.
FormatX.509 certificate, PEM or base64 DER.
IssuerSelf-signed is accepted. No chain is checked.
Basic ConstraintsPresent, with CA:FALSE.
Key UsagePresent, including digitalSignature.
ValidityAlready valid, with at least 30 days left.

Generate them​

One command creates both files. It needs OpenSSL 1.1.1 or later.

openssl req -x509 -newkey rsa:3072 -sha256 -days 730 -nodes \
-keyout ryno-partner.key \
-out ryno-partner.crt \
-subj "/CN=your-company-ryno-partner" \
-addext "basicConstraints=critical,CA:FALSE" \
-addext "keyUsage=critical,digitalSignature"
FileWhat it isWhere it goes
ryno-partner.keyPrivate keyYour secrets manager or HSM. Nowhere else.
ryno-partner.crtPublic certificateThe Partner Portal, in the next step.
danger

Never send the private key to Ryno, commit it to source control, or paste it into a shared tool. Ryno will reject any upload that contains a private key.

Check the certificate​

openssl x509 -in ryno-partner.crt -noout -subject -enddate -ext basicConstraints,keyUsage

You should see CA:FALSE, Digital Signature, and an end date well in the future.

info

Plan the validity period now. A registered certificate cannot be replaced from the portal, so a two-year certificate avoids an early rotation. See Token lifecycle.