Skip to main content

Delays to response times: It's taking longer than usual to answer calls and myIR messages. You may be able to use self-service options in myIR or on our self-service line, 0800 257 777. You can also find information on our website by typing in what you want to do in the search bar. Thank you for your understanding. Log in to myIR

Cost of Living Payment The Government has announced a Cost of Living Payment, which will be paid from 1 August 2022. You do not need to apply for this payment. If you are eligible, we’ll pay it into your bank account. Find out more

Identity and access service

You'll need to be able to:

  • get and set up a TLS (SSL) connection client side X509 certificate for web service client connections in test and production (primarily for Cloud originating connections)
  • complete OAuth2 integration
  • identify internet-facing IP addresses that SOAP requests will come from
  • apply X509 client certificates for client side of TLS mutual authentication for all connection requests
  • do a local network trace to see exactly what has been sent and received, including HTTP headers and ideally a TLS handshake.

For services relating to SFTP related set up, you may need to:

  • exchange SSH keys
  • exchange PGP keys for file signing and encryption
  • make firewall changes to open incoming ports
  • apply PGP decryption, validation, encryption and signing depending on specific integration.

Identity and access roles

Party Requirement Description
Provide public certificate for mutual TLS Inland Revenue's public X.5.9 certificate to support TLS is provided as part of connectivity testing.
Get a X.509 certificate from a certificate authority for the test and production environments. Required when using mutual TLS with cloud-based software providers.

Identity and access

SOAP API architecture

Our gateway services use the SOAP API architecture.

You'll need to undertake SOAP web service development and testing using:

  • request and response operations
  • XSD schemas and WSDL.

Operations and message structure

Last updated: 28 Apr 2021
Jump back to the top of the page