Install axe DevTools for Web for Java from Deque's Agora
Installing axe DevTools for Web for Java using Deque's Agora artifact repository with Maven
For customers who do not have an internal artifact repository and desire a more sustainable and scalable solution for installation than downloading bundles, Deque makes its own artifact repository available to select customers. For information on other ways to install axe DevTools, see the guides on Installing from a Bundle or Installing from your Nexus repository.
Prerequisites
In order to install axe DevTools from Agora, you must have Agora login credentials. Additionally, you must have an existing Java web project to integrate with.
Creating An Identity Token
The simplest way to create an Identity Token is through the Agora webapp. Once logged in, you can generate an Identity Token by clicking on the button labeled Welcome your-email-address in the top bar next to the help button and then clicking on Generate an Identity Token. Follow the steps to generate and copy your Identity Token.
Remember to copy your Identity Token's value when creating it, as this will be your only opportunity. Otherwise, you'll have to create a new token.
Identity Tokens expire (usually after a year), so you'll need to recreate your token periodically.
Adding Authentication
For Maven users, authentication information is added in the settings.xml file, located in the ~/.m2 directory. If you have an existing settings.xml file, add this server object to the servers object and add your email address and Identity Token.
<server>
<id>deque</id>
<username>youremail@yourdomain.com</username>
<password>your-identity-token</password>
</server>If you don't have a ~/.m2/settings.xml file configured, this template can be used. Your email address and Identity Token will need to be substituted in this template as well.
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.worg/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
http://maven.apache.org/xsd/settings-1.0.0.xsd">
<servers>
<server>
<id>deque</id>
<username>youremail@yourdomain.com</username>
<password>your-identity-token</password>
</server>
</servers>
</settings>Installing
To install axe DevTools in your project, first add this repository object to your <repositories> object.
<repository>
<id>deque</id>
<url>https://agora.dequecloud.com/artifactory/devtools-maven</url>
</repository>Then, add the dependency to the <dependencies> object. Replace $binding with either Selenium, Hamcrest, Cucumber, or Playwright depending on your testing setup. Replace $version with your version.
<dependency>
<groupId>com.deque.html.axe-devtools</groupId>
<artifactId>$binding</artifactId>
<version>$version</version>
</dependency>To test whether maven is able to access and install these dependencies, run the command "mvn install" from the command line in the same directory as your pom.xml file.
Next Steps
Once axe DevTools has been successfully installed in your environment, read the guide on importing and initializing.
If you have issues installing axe DevTools, contact your Deque representative directly, ask us via our support desk, or send us an email. We'll be happy to help you get up and running.