{"id":2949914,"date":"2025-11-26T07:42:14","date_gmt":"2025-11-26T15:42:14","guid":{"rendered":"https:\/\/www.esri.com\/arcgis-blog\/?post_type=blog&p=2949914"},"modified":"2026-03-20T12:43:53","modified_gmt":"2026-03-20T19:43:53","slug":"new-in-arcgis-enterprise-12-0-service-interceptors","status":"publish","type":"blog","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/developers\/new-in-arcgis-enterprise-12-0-service-interceptors","title":{"rendered":"New in ArcGIS Enterprise 12.0: service interceptors"},"author":10222,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"_acf_changed":false,"_searchwp_excluded":""},"categories":[738191],"tags":[780876,780849,759622,780923,35821],"industry":[],"product":[36571],"class_list":["post-2949914","blog","type-blog","status-publish","format-standard","hentry","category-developers","tag-12-0","tag-arcgis-enterprise-12-0","tag-arcgis-enterprise-sdk","tag-arcgis-enterprise-service-interceptors","tag-whats-new-in-arcgis-enterprise","product-arcgis-enterprise"],"acf":{"short_description":"ArcGIS Enterprise 12.0 introduces service interceptors, which allow you to intercept REST requests to all GIS services.","flexible_content":[{"acf_fc_layout":"content","content":"

The ability to intercept web requests for all types of GIS services is one of the most requested features for ArcGIS Enterprise SDK \u2013 and we have heard you!\u00a0 With the introduction of service interceptors, a new feature included in the ArcGIS Enterprise 12.0 release<\/a>, you can now intercept REST-based requests to all<\/em> GIS services.\u00a0 This means hosted feature layers, geocode services, and more.<\/p>\n

Note: Service interceptors are only available for ArcGIS Enterprise on Windows and Linux and are not yet available in ArcGIS Enterprise on Kubernetes.<\/em><\/p>\n

Read on to learn more about service interceptors; how they tie into the ArcGIS Enterprise SDK, what they are, and a quick overview of the steps to create them in your own ArcGIS Enterprise environment.<\/p>\n"},{"acf_fc_layout":"sidebar","content":"

Quick Links<\/strong><\/h2>\n

ArcGIS Enterprise SDK review <\/a> | Understanding service interceptors<\/a> | Developing a service interceptor<\/a><\/p>\n","image_reference":false,"layout":"standard","image_reference_figure":"","snippet":"","spotlight_name":"","section_title":"","position":"Center","spotlight_image":false},{"acf_fc_layout":"content","content":"

Sound familiar?<\/em><\/h2>\n

You may have already heard about service interceptors in ArcGIS Enterprise earlier this year at our Developer and Technology Summit in Palm Springs.\u00a0 Be sure to check out the video below for a demo in action!<\/em><\/p>\n"},{"acf_fc_layout":"kaltura","video_id":"1_ak8j83yj\/373383312","time":false,"start":0,"stop":""},{"acf_fc_layout":"content","content":"

ArcGIS Enterprise SDK review<\/h1>\n

Before getting into service interceptors, let\u2019s review what has already been available in the ArcGIS Enterprise SDK.\u00a0 The ArcGIS Enterprise SDK, introduced with ArcGIS Enterprise 10.6.1, allows developers to extend ArcGIS Enterprise functionalities.\u00a0 This includes extending the functionality of map services and image in the form of server object extensions (SOEs) and server object interceptors (SOIs)<\/a>.\u00a0 Custom data feeds<\/a>, introduced with ArcGIS Enterprise 11.1<\/a>, enables connecting to and integrating with remote data sources not natively supported otherwise.<\/p>\n

To understand service interceptors, it\u2019s important to first understand a bit more about SOIs.\u00a0 SOIs intercept requests for built-in operations of individual referenced map services and image services from user-managed data sources.\u00a0 This allows for the execution of custom logic that is seamless to existing ArcGIS clients, as well as clients outside of the ArcGIS system.<\/p>\n"},{"acf_fc_layout":"image","image":{"ID":2950011,"id":2950011,"title":"SOIs","filename":"Slide1.jpg","filesize":94467,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/developers\/new-in-arcgis-enterprise-12-0-service-interceptors\/slide1-9","alt":"Diagram of how SOIs can be applied to individual map and image services.","author":"10222","description":"Diagram of how SOIs can be applied to individual map and image services.","caption":"Diagram of how SOIs can be applied to individual map and image services.","name":"slide1-9","status":"inherit","uploaded_to":2949914,"date":"2025-11-25 18:15:56","modified":"2025-11-25 18:16:13","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1500,"height":844,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1.jpg","medium-width":464,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1.jpg","medium_large-width":768,"medium_large-height":432,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1.jpg","large-width":1500,"large-height":844,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1.jpg","1536x1536-width":1500,"1536x1536-height":844,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1.jpg","2048x2048-width":1500,"2048x2048-height":844,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1-826x465.jpg","card_image-width":826,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide1.jpg","wide_image-width":1500,"wide_image-height":844}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

<\/a><\/p>\n

 <\/p>\n

Understanding service interceptors<\/h1>\n

Now that we\u2019re all on the same page about SOIs, we can get into service interceptors.\u00a0 Just like SOIs, service interceptors also expand standard REST requests and responses through pre or post processing.\u00a0 Where SOIs are limited to referenced map and image services, service interceptors can be applied to all GIS services that can be published to ArcGIS Server – regardless of if it’s federated with an ArcGIS Enterprise portal or a standalone instance.\u00a0 Service interceptors can also be configured to be applied to multiple GIS services at once, where SOIs have to be applied to individual GIS services.<\/p>\n

We’ll get into a lot of the details but know that more on this topic can be found in the service interceptors product documentation<\/a>.<\/p>\n

 <\/p>\n"},{"acf_fc_layout":"image","image":{"ID":2950013,"id":2950013,"title":"Service interceptors","filename":"Slide2.jpg","filesize":87941,"url":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2.jpg","link":"https:\/\/www.esri.com\/arcgis-blog\/products\/arcgis-enterprise\/developers\/new-in-arcgis-enterprise-12-0-service-interceptors\/slide2-11","alt":"Diagram of how service interceptors can be applied to all types of GIS services published to ArcGIS Server.","author":"10222","description":"Diagram of how service interceptors can be applied to all types of GIS services published to ArcGIS Server.","caption":"Diagram of how service interceptors can be applied to all types of GIS services published to ArcGIS Server.","name":"slide2-11","status":"inherit","uploaded_to":2949914,"date":"2025-11-25 18:16:46","modified":"2025-11-25 18:16:57","menu_order":0,"mime_type":"image\/jpeg","type":"image","subtype":"jpeg","icon":"https:\/\/www.esri.com\/arcgis-blog\/wp-includes\/images\/media\/default.png","width":1500,"height":844,"sizes":{"thumbnail":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2-213x200.jpg","thumbnail-width":213,"thumbnail-height":200,"medium":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2.jpg","medium-width":464,"medium-height":261,"medium_large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2.jpg","medium_large-width":768,"medium_large-height":432,"large":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2.jpg","large-width":1500,"large-height":844,"1536x1536":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2.jpg","1536x1536-width":1500,"1536x1536-height":844,"2048x2048":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2.jpg","2048x2048-width":1500,"2048x2048-height":844,"card_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2-826x465.jpg","card_image-width":826,"card_image-height":465,"wide_image":"https:\/\/www.esri.com\/arcgis-blog\/app\/uploads\/2025\/11\/Slide2.jpg","wide_image-width":1500,"wide_image-height":844}},"image_position":"center","orientation":"horizontal","hyperlink":""},{"acf_fc_layout":"content","content":"

Relationship between service interceptors and SOIs<\/h2>\n

Both service interceptors and server object interceptors (SOIs) extend ArcGIS Enterprise by allowing custom logic to run which can intercept request and response.\u00a0 Although they sit at different layers of the architecture, they share the common goal of enhancing, validating, or modifying service behavior.<\/p>\n

Choosing between them isn\u2019t an either\u2013or decision.\u00a0 In fact, many enterprise workflows benefit from using both together.\u00a0 At a high-level, it’s important to keep in mind that:<\/p>\n