Add End-Customer Information for a Registered VM-Series Firewall
Focus
Focus
VM-Series

Add End-Customer Information for a Registered VM-Series Firewall

Table of Contents

Add End-Customer Information for a Registered VM-Series Firewall

Use the Palo Alto Networks Support portal or the Licensing API to link the serial number of the VM-Series firewall with customer provisioned firewall.
Where Can I Use This?What Do I Need?
  • VM-Series deployment
  • VM-Series 10.x or above
  • Panorama running PAN-OS 10.1.x or above versions
  • Customer Support Portal (CSP) account with one of the following user roles:
    • Superuser, Standard User, Limited User, Threat Researcher, AutoFocus Trial Role, Group superuser, Group Standard User, Group Limited User, Group Threat Researcher, Authorized Support Center (ASC) User, and ASC Full Service User.
    • Superuser access to the VM-Series firewall
For CSSP licensees, after you register the firewall, you can use either the Palo Alto Networks Support portal or the Licensing API to link the serial number of the VM-Series firewall with the customer for whom you provisioned the firewall.

Add End-Customer Information for a Registered VM-Series Firewall (Customer Support Portal)

Complete the following procedure to add end-customer information for a registered firewall through the Customer Support Portal.
  1. Log in to the Palo Alto Networks Customer Support website with your account credentials.
  2. Select CSSPProvisioned Devices.
  3. Select the Serial Number and click Add End User Info.
  4. Enter the Account Information for the customer as follows.
    • Customer Reference Id: Required
    • Company Name: Required
    • DNB #: Data Universal Numbering System (D-U-N-S) number
    • Contact Email: Required, end-user email address
    • Contact Phone Number: End-user phone number
    • Address: Required, end-user address
    • Country: Required, ISO 2-letter country code
    • City: Required, end-user city name
    • Region/State: Required; for the United States and Canada, you must enter an ISO 2-letter subdivision code; for all other countries, any text string is valid
    • Postal Code: Required, end-user postal code
    • Company Website: End-user website URL
    • Industry: End-user industry type, such as networking or consultancy
    Click Submit to save the details.
    After you add account information, you can find all firewalls registered to a customer. In Search Existing End User, enter the customer ID or customer name and click Search to find all firewalls provisioned for the customer.

Add End-Customer Information for a Registered VM-Series Firewall (API)

An API request must use the HTTP POST method, and you must include HTTP requests headers that include the API key and specify the content type as JSON. API responses are in JSON format.
  1. Use the ReportEndUserInfo API to add end-user information for a VM-Series Firewall that is registered to a CSSP.
    URL: https://api.paloaltonetworks.com/api/license/ReportEndUserInfo
    Headers:
    • Content-Type: application/json
    • apiKey: API Key
    Parameters:
    • SerialNumbers: Required, provide at least one valid firewall serial number
    • CustomerReferenceId: Required
    • CompanyName: Required, end-user company name
    • DnBNumber: Data Universal Numbering System (D-U-N-S) number
    • PhoneNumber: End-user phone number
    • EndUserContactEmail: Required, end-user email address
    • Address: Required, end-user address
    • Country: Required, ISO 2-letter country code
    • City: Required, end-user city name
    • Region/State: Required; for the United States and Canada, you must enter an ISO 2-letter subdivision code; for all other countries, any alpha string is valid
    • PostalCode: Required, end-user postal code
    • Industry: End-user industry type, such as networking or consultancy
    • WebSite: End-user website URL
    • CreatedBy: System or person submitting this information
    Sample request to add end-user information for a registered VM-Series firewall using Curl:
    curl -X POST "http://api.paloaltonetworks.com/api/license/ReportEndUserInfo" \-H "Content-Type: application/json" \-H "apikey: your_key_here" \--data-raw '{ "SerialNumbers": ["0001A101234"], "CustomerAccountId": 12345, "CompanyName": "ExampleInc", "DnBNumber": "123456789", "Address": "123 Main St", "City": "Sunnydale", "Region": "CA", "State": "CA", "Country": "US", "PostalCode": "12345", "Industry": "Medical", "PhoneNumber": "4081234567", "WebSite": "example.com", "EndUserContactEmail": "admin@example.com", "CreatedBy": "Jane Doe"}'
    Sample API response:
    "{"Message": "End User Information Updated Successfully"}"
    If you receive an error, see Licensing API Error Codes.