Skip to main content

Change log

Version 3.3

27 January 2025

  • Clarification that for Gov-Client-Multi-Factor, the timestamp field must contain a T and use the 24 hour format.
  • Clarification that for Gov-Client-Screens and Gov-Client-Window-Size, width and height must be positive whole numbers.
  • Clarification that the separators used in Gov-Client-User-Agent must not be percent encoded.
  • Correction that for Gov-Vendor-Forwarded, the first hop must contain the value of Gov-Vendor-Public-IP.

The Directions were updated 16 April 2025.

To check what you need to send, select your connection method.

Version 3.2

1 August 2023

  • For the mobile application via server and mobile application direct connection methods, you do not need to provide a value for os in Gov-Client-User-IDs. If your application submits values for os it is not an issue.
  • For the mobile application via server and mobile application direct connection methods, you do not need to submit values for Gov-Client-MAC-Addresses. If your application submits values for this header it is not an issue.
  • For the web application via server connection method, you do not need to submit a value for Gov-Client-Browser-Do-Not-Track. If your application submits values for this header it is not an issue.
  • Clarification that Gov-Vendor-Forwarded must contain values from Gov-Vendor-Public-IP and Gov-Client-Public-IP
  • Clarification on how many key-value pairs to include in Gov-Vendor-Version

Version 3.1

4 April 2022

  • Clarification on format for Gov-Client-Timezone

31 January 2022

  • For the web application via server connection method, you do not need to submit values for Gov-Client-Browser-Plugins, Gov-Client-Local-IPs or Gov-Client-Local-IPs-Timestamp. If your application submits values for these headers it is not an issue.
  • For all connection methods other than web application via server, you still need to submit values for Gov-Client-Local-IPs and Gov-Client-Local-IPs-Timestamp

Version 3.0

12 July 2021

  • Clarification on fields for Gov-Client-User IDs

3 June 2021

  • Added a link to the Compliance and Sanctions Guidelines

30 April 2021

  • Clarification on the format for Gov-Client-Public-IP-Timestamp and Gov-Client-Local-IPs-Timestamp

6 January 2021

  • Gov-Client-Local-IPs-Timestamp is a new header for all connection methods
  • Gov-Client-Public-IP-Timestamp is a new header for via server connection methods
  • Gov-Vendor-Product-Name is a new header for all connection methods
  • Gov-Client-Device-ID must be submitted as a universally unique identifier (UUID)
  • Gov-Client-User-Agent must be submitted as a key-value structure
  • Clarification that Gov-Client-Multi-Factor accepts seconds and milliseconds
  • Clarification on when to collect values for Gov-Client-Local-IPs