Knowledge Base
medianova.comSupportLog in
  • Welcome to the Medianova Knowledge Base
  • Getting Started
    • Concepts
    • Start your Free Trial
  • Products
    • Security
      • DDoS Protection
      • SSL/TLS Encryption
        • How to upload and manage SSL Certificates?
        • How to Extract CRT and KEY Files from a PFX Certificate
        • How can I use Free SSL?
        • FAQ
      • Web Application Firewall (WAF)
        • How to activate WAF?
        • Analytics
      • Rate Limiting
      • Hotlink Protection
      • IP Restriction
      • Geoblocking
      • FAQs
    • Performance / CDN
      • Static Content Delivery
        • Create Small Resource
        • Create Large Resource
        • Integrating Static CDN Resource
        • Configuration Basics
          • Medianova IP Blocks
        • Advanced Configuration
          • Origin Settings
            • Advanced Origin Settings
            • Rewrite Origin URLs
            • Origin SNI Request
            • Redirect Handle From Origin
            • Origin Response Timeout
          • CNAME
          • Caching
            • Edge Cache Expiration
            • Browser Cache Rule
            • Query String Caching
            • Etag Verification
            • Error Status Code Cache Expiration
            • Shared Cache
            • Stale Cache
            • Robots.txt file
            • Range Based Caching
          • Headers
            • CORS Header
            • Custom Header
            • X-CDN Header
            • Origin Host Header
            • HTTP Strict Transport (HSTS) Protection
            • X-Frame Options
            • X-XSS Protection
            • X-Content Type Options
          • Purge
          • Prefetch
          • Page Rules
            • Manage Page Rules
            • Page Rules Settings
          • Compression
            • How to Configure Gzip and Brotli
        • Website Framework Integrations
          • Magento CDN Integration
          • Wordpress CDN Integration
          • Phalcon CDN Integration
          • CakePHP CDN Integration
        • Analytics
      • Dynamic Content Acceleration
        • Create Dynamic Resource
        • Integrating Dynamic CDN Resource
        • Aksela Test Steps
        • Advanced Configuration
          • Origin Settings
            • Advanced Origin Settings
            • Rewrite Origin URLs
            • Origin SNI Request
            • Redirect Handle From Origin
            • Origin Response Timeout
          • Caching
            • Edge Cache Expiration
            • Browser Cache Rule
            • Query String Caching
            • Etag Verification
            • Error Status Code Cache Expiration
            • Shared Cache
            • Stale Cache
            • Disallow Cookie Base Cache
            • Cookie Base Cache
            • Header Base Cache
            • Header Value Base Cache
            • MNUID Cookie Base Cache
            • Mobile Redirect
          • Headers
            • CORS Header
            • Custom Header
            • X-CDN Header
            • Origin Host Header
            • HTTP Strict Transport (HSTS) Protection
            • X-Frame Options
            • X-XSS Protection
            • X-Content Type Options
          • Purge
          • Prefetch
          • Page Rules
          • Compression
        • Analytics
      • Streaming Content Delivery
        • Create Streaming Resource
        • Advanced Configuration
          • Origin Settings
            • Redirect Handle From Origin
            • Origin Response Timeout
          • Headers
            • CORS Header
            • Custom Header
            • X-CDN Header
            • Origin Host Header
          • Stream Management
        • Analytics
      • API Caching
      • Private CDN
      • Image Optimization and WebP
        • What is Image Optimization and How Does It Work?
        • What is WebP and How Does It Work?
        • How to Activate Image Optimization and WebP?
        • Analytics
      • FAQs
    • Object Storage / Stook
      • What is Stook?
      • How to Create Stook?
      • How to Connect Bucket?
      • Access Key Management
      • Stook Integration and Usage Guides
        • Migrating Data to Stook Using Rclone
        • Data Transfer to Stook with Cyberduck
        • How to use the AWS SDK for Laravel with Stook?
        • How to use the AWS SDK for PHP with Stook?
        • How do I use the AWS SDK for .NET with Stook?
        • Stook Storage User Guide for AWS CLI
        • How to use AWS SDK for JavaScript with Stook?
        • How do I use Stook with the AWS Java SDK?
        • Using Pre-Signed URL PHP with Stook
        • Using Pre-Marked URL NODEJS With Stook
    • Analytics (MN Logz)
      • Real-Time Logpush
      • Raw Logs
  • Account & Billing
    • Managing Account and Organizations
      • Create new organization
      • Invite user
      • Changing Cloud Panel password
      • Access Controls and Authentication
    • Subscription and Billing
      • Packages
        • Free Trial
        • Starter
        • Growth
        • Enterprise
        • Add-ons
      • Policy
      • Upgrade & Downgrade Procedures
      • Changing your subscription package
      • Payment Info
      • Invoices
  • API Documentation
    • Authentication
    • Security
      • Web Application Firewall (WAF)
      • SSL/TLS
      • Always Use HTTPS Settings
      • Origin Basic Authentication
      • Secure Token
      • Bot Protection
      • Hotlink Protection
      • User Agent ACL
      • IP Restriction ACL
      • Geoblocking
    • Performance / CDN
      • Resources
      • Origin Settings
      • CNAME & SSL
      • Caching
      • Headers
      • Image Optimization & WebP
      • Page Rule
      • Purge
      • Prefetch
      • Stream Management
    • Object Storage / Stook
    • Analytics
      • WAF Analytics
  • Support and Troubleshooting
    • Common Issues and Solutions
      • Troubleshooting Common Setup Issues
      • Troubleshooting Performance Problems
    • Contacting Customer Support
  • Glossary
    • Definition of Important CDN Terms
    • Acronyms and Abbreviations
    • Definition of HTTP Status Error Codes
Powered by GitBook
LogoLogo

© 2025 Medianova. All rights reserved.

On this page

Was this helpful?

Export as PDF
  1. API Documentation
  2. Security

SSL/TLS

Last updated 4 months ago

Was this helpful?

List SSL

get
Authorizations
Path parameters
organization_uuidanyRequired

The unique identifier of the organization.

Query parameters
ssl_nameany ofOptional

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

stringOptional
or
nullOptional
common_namestringOptional

Filter by common name

sort_fieldall ofOptional

Field to sort by

Default: created_at
string · enumOptionalPossible values:
sortall ofOptional

Sort order

Default: desc
string · enumOptionalPossible values:
pageintegerOptional

Page number

Default: 1
per_pageintegerOptional

Items per page

Default: 24
Responses
200
Successful Response
application/json
422
Validation Error
application/json
get
GET /api/v1/ssl/{organization_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "organization_uuid": "text",
      "ssl_name": "text",
      "expire_date": "2025-05-09T05:13:46.613Z",
      "common_name": "text",
      "created_at": "2025-05-09T05:13:46.613Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ],
  "paginate": [
    {
      "current_page": 1,
      "per_page": 1,
      "total": 1,
      "last_page": 1
    }
  ]
}

Delete SSL

delete
Authorizations
Path parameters
organization_uuidanyRequired

The unique identifier of the organization.

ssl_uuidanyRequired

The created SSL in panel unit ID value.

Responses
200
Successful Response
application/json
Responseany
422
Validation Error
application/json
delete
DELETE /api/v1/ssl/{organization_uuid}/{ssl_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

  • POSTCreate SSL
  • PUTUpdate SSL
  • GETList SSL
  • DELETEDelete SSL
  • POSTLets Encrypt DNS Challenge
  • POSTLets Encrypt Create CERT

Create SSL

post
Authorizations
Path parameters
organization_uuidanyRequired

The unique identifier of the organization.

Body

SSL Create

ssl_namestring · min: 3 · max: 55Required

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

ssl_crtstringRequired

A string containing the certificate file of the SSL certificate. This parameter represents the content of the server's SSL certificate.

ssl_passany ofRequired

A string containing the password for the SSL certificate's private key. This parameter contains the password for the private key of the SSL certificate.

stringOptional
or
nullOptional
ssl_keystringRequired

A string containing the private key file for the SSL certificate. This parameter represents the private key used for the SSL certificate.

typeany ofOptionalDefault: custom
string · enumOptional

SSL Type

Possible values:
or
nullOptional
challenge_subdomainany ofOptional

Challenge Subdomain

stringOptional
or
nullOptional
Responses
200
Successful Response
application/json
422
Validation Error
application/json
post
POST /api/v1/ssl/{organization_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "ssl_name": "text",
  "ssl_crt": "text",
  "ssl_pass": "text",
  "ssl_key": "text",
  "type": "custom",
  "challenge_subdomain": "text"
}
{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "organization_uuid": "text",
      "ssl_name": "text",
      "expire_date": "2025-05-09T05:13:46.613Z",
      "common_name": "text",
      "created_at": "2025-05-09T05:13:46.613Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ]
}

Update SSL

put
Authorizations
Path parameters
orgnization_uuidanyRequired

The unique identifier of the organization.

ssl_uuidanyRequired

The created SSL in panel unit ID value.

Body

SSL Update

ssl_nameany ofRequired

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

stringOptional
or
nullOptional
ssl_crtstringRequired

A string containing the certificate file of the SSL certificate. This parameter represents the content of the server's SSL certificate.

ssl_passany ofRequired

A string containing the password for the SSL certificate's private key. This parameter contains the password for the private key of the SSL certificate.

stringOptional
or
nullOptional
ssl_keystringRequired

A string containing the private key file for the SSL certificate. This parameter represents the private key used for the SSL certificate.

Responses
200
Successful Response
application/json
422
Validation Error
application/json
put
PUT /api/v1/ssl/{organization_uuid}/{ssl_uuid}/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 71

{
  "ssl_name": "text",
  "ssl_crt": "text",
  "ssl_pass": "text",
  "ssl_key": "text"
}
{
  "status": true,
  "data": [
    {
      "uuid": "text",
      "organization_uuid": "text",
      "ssl_name": "text",
      "expire_date": "2025-05-09T05:13:46.613Z",
      "common_name": "text",
      "created_at": "2025-05-09T05:13:46.613Z",
      "type": "custom",
      "challenge_subdomain": "text"
    }
  ]
}

Lets Encrypt DNS Challenge

post
Authorizations
Path parameters
organization_uuidstringRequired

The unique identifier of the organization.

Body

Certificate Generation Request

domainstringRequired

Associated Domain Name

wildcardbooleanOptional

Is Wildcard Certificate

Default: false
Responses
200
Successful Response
application/json
Responseany
422
Validation Error
application/json
post
POST /api/v1/ssl/{organization_uuid}/lets-encrypt/initiate-dns-verification/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "domain": "text",
  "wildcard": true
}

No content

Lets Encrypt Create CERT

post
Authorizations
Path parameters
organization_uuidstringRequired

The unique identifier of the organization.

Body

CompleteCertRequest

ssl_namestring · min: 3 · max: 55Required

The name or description of the SSL certificate. This parameter contains the name or description of the SSL certificate used by the server or service.

domainstringRequired

Associated Domain Name

cname_targetstring · min: 3 · max: 255Required

CNAME Record Target

wildcardbooleanOptional

Is Wildcard Certificate

Default: false
Responses
200
Successful Response
application/json
Responseany
422
Validation Error
application/json
post
POST /api/v1/ssl/{organization_uuid}/lets-encrypt/finalize-ssl-creation/ HTTP/1.1
Host: cloud.medianova.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "ssl_name": "text",
  "domain": "text",
  "cname_target": "text",
  "wildcard": true
}

No content