Manual Chapter :
Configuring an ATI Profile
Applies To:
Show VersionsBIG-IP Distributed Cloud Services
- 17.0.0
Configuring an ATI Profile
Before configuring an ATI profile in the BIG-IP, you
need to first add your web application to the ATI Dashboard in the F5 XC Console and
choose BIG-IP for the JavaScript injection method.
Configure an ATI profile to get insight into unwanted
user connections, devices, and behavior on your web application.
- On the Main tab, click.The ATI Profiles screen displays the list of ATI profiles on the system.
- ClickCreate.The New ATI Profile screen opens.
- In the Basic/Advanced Toggle, selectAdvanced.If you are configuring a standard deployment for the U.S. cluster, you can select Basic configuration and assign values for just the Basic settings. In this case, all the default values for the Advanced settings are used and all data traffic is sent and stored in the U.S. cluster.
- In theProfile Namefield, enter a unique name for the ATI profile.
- Optional:In theDescriptionfield, enter a description of the profile.
- AtUse Proxy Server, selectYesif you want to route data via a proxy server so that it won't be sent directly from the BIG-IP to the ATI backend server.Some deployments may require proxy support with basic authentication to control outbound traffic towards internet.
- IfUse Proxy ServerisNo:
- AtAPI Domain Pool: If you are creating an ATI profile for the first time, click the+button to create a new pool using the domain you received in JS URL in F5 XC Console (or from F5 Support).For example, if you received the following JS URL:https://us.gimp.zeronaught.com/__imp_apg__/js/volt-volterra_abcdefg-12345678.jsuse the domainus.gimp.zeronaught.comwhen creating the pool.
- AtAPI Hostname: Enter here the same domain used in API Domain Pool.
- IfUse Proxy ServerisYes:
- AtProxy Pool: Select a Proxy Pool from the drop-down list, or click the+button to configure a new proxy pool.If you click the+button, the pool configuration screen appears. In the pool configuration screen, create a new pool with explicit proxy nodes. When you clickFinishin the pool configuration screen, you return to the ATI Profile properties screen.
- AtProxy Username: Enter a user name for proxy authorization. This setting is needed only if your proxy server requires this.
- AtProxy Password: Enter a password for proxy authorization. This setting is needed only if your proxy server requires this.
- AtProxy Destination: Enter here the protocol and domain from the JS URL you received in the F5 XC Console (or from F5 Support).For example, if you received the following JS URL:https://us.gimp.zeronaught.com/__imp_apg__/js/volt-volterra_abcdefg-12345678.js,enter here:https://us.gimp.zeronaught.com.Optionally, you can add a port number if you are using a port that is not standard for http or https. Using the example above, if you want to use port 550, enter here:https://us.gimp.zeronaught.com:550.
- AtSSL Profile, select an SSL profile (or use the default) that will be attached to a new virtual server for routing traffic to the Service Pool.
- AtJavaScript Path, enter the path starting with/__imp_apg__/in the JS URL that you received in the F5 XC Console (or from F5 Support).For example, if you received the following JS URL:https://us.gimp.zeronaught.com/__imp_apg__/js/volt-volterra_abcdefg-12345678.js, use the path/__imp_apg__/js/volt-volterra_abcdefg-12345678.js.
- AtTelemetry Path, do not change the path here unless instructed to do so by F5 Support.
- AddConnecting IP to Headers, selectYesto add a new header with a connecting IP to the HTTP request.If you want the connecting IP to be added to the XFF header, do that in an HTTP profile attached to one of the web application’s virtual servers.
- AtConnecting IP Header Name, do not change the header name unless instructed to do so by F5 Support.This setting is displayed only ifAdd Connecting IP to HeadersisYes.
- At Injection Location, select eitherAfter <head>orAfter <body>for the location of the JS injection.
- AtScript Attribute, choose an attribute that is added at the end of the injected JS, eitherAsync Defer, Async, Sync,orDefer. This attribute determines how the JavaScript is loaded and executed.
- AtInject in Specific Paths, selectYesto inject the JS in specific web pages of your web application. SelectNoto inject the JS in all web pages of your web application.
- IfInject in Specific PathsisYes, at Injection Paths enter the relative paths of the webpages in your application to receive the JS injections. You can use*for wildcard pattern matching.
- AtExclude Injection from Specific Paths, selectYesto exclude the JS injection from specific web pages in your web application.
- IfExclude Injection from Specific PathsisYes, enter the relative paths of the web pages in your application that the JS injections should be excluded from. You can use*for wildcard pattern matching.
- AtiRules, select iRules to attach to theAPI Domain PoolorProxy Pool. iRules help automate the intercepting, processing, and routing of ATI-related traffic to the ATI backend server.
- Enabled:Lists the iRules on the system that are already applied to theAPI Domain PoolorProxy Pool. The BIG-IP applies iRules in the order that they appear in the list. You can change the order using the up and down buttons.
- Available:Lists the iRules on the system that are available to apply on theAPI Domain PoolorProxy Pool.
- ClickSave.
After you have configured your ATI profile, you need
to assign that profile to a virtual server.