Skip To Content

Print maps that contain secured services

You can use the PrintingTools service to print maps that contain secure services.

Web-tier authentication

If your ArcGIS Server is federated with an ArcGIS Enterprise portal and only the portal's ArcGIS Web Adaptor uses web-tier authentication (IWA, PKI, Basic, and so on), printing secured services will work as expected. The same is true for deployments that do not use web-tier authentication systems.

However, if your ArcGIS Server site's Web Adaptor uses web-tier authentication, the PrintingTools service and custom print services will not be able to print any of your site's services. This restriction exists for both federated and stand-alone ArcGIS Server sites.

Short-term tokens

If you secure your services using short-term tokens (the default), the user will be asked to provide the name and password upon opening the web app. The token is then passed to the PrintingTools service when the user requests a map to be printed.

Embed credentials into a service

In some cases when publishing your own print service that contains secured services, you need to embed credentials into the print service that it can use when requesting maps from the secured services. The steps at the end of this section detail how to do so.

If you embed a long-term token in your web app code, the authentication information cannot be passed to the PrintingTools service. Regardless of your server configuration, you need to embed credentials into the print service using the steps below.

If you enforce security at the web server tier, and your ArcGIS Server is federated with an ArcGIS Enterprise portal, printing maps with the PrintingTools service is supported by default with no additional steps needed. However, if you have a stand-alone installation of ArcGIS Server and you enforce security at the web server tier, you need to embed credentials using the steps below.


It is not recommended to embed credentials in a custom print service without fully understanding the security impact. If you choose to publish your own service for printing with embedded credentials, it's recommended that you apply ArcGIS Server security rules to restrict who can access the service. This prevents anonymous users from generating printable map images that display your secured services. See Control access to your services to learn more about setting up security.


These steps are only available when preparing a print service to be published from ArcMap. To embed credentials in a custom print service from ArcGIS Pro, you can use the ImportCredentials function in ArcPy.

  1. In the Catalog window of ArcMap, expand Toolboxes > My Toolboxes.
  2. Right-click My Toolboxes and click New > Toolbox.
  3. Give your toolbox a name, such as SecurePrinting.tbx.
  4. In the Catalog tree, expand Toolboxes > System Toolboxes > Server Tools.tbx > Printing.
  5. Right-click the Export Web Map tool and click Copy.
  6. Right-click the toolbox you created in step 2 and click Paste.
  7. Right-click the pasted Export Web Map tool from your own toolbox and click Edit.
  8. Click the Plus Sign (+) button and browse to the GIS server connection that contains the secured services you want to print.

    The connection needs to have the name and password saved with it. It should be a user connection, not a publisher or administrative connection.

    If you don't see any connections available, return to the Catalog tree and make one, using the instructions in Connect to ArcGIS Server from ArcGIS Desktop.

    You can add connections to as many servers as you need to support your printing service. Click OK when you finish adding connections.

  9. Publish the Export Web Map tool from your own toolbox as a geoprocessing service using the steps in Tutorial: Publish additional services for printing. In step 2 of the tutorial, open the Export Web Map tool you pasted during the steps above. Do not open the original Export Web Map tool from the Server Tools toolbox.