> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connecting ANS to Neo

> Register an API application in ANS Glass, save its key in Neo, and turn ANS on per agent

You connect the ANS account that holds your domains and services once, at the MSP level. A customer that keeps its own ANS account can add its own key later (**Add a customer's own key** on the card).

## 1. Register an API application in Glass

**1. Sign in**

Sign in to [Glass](https://www.ans.co.uk/login/), the ANS portal, with an account that can manage API applications.

**2. Register the application**

Open **API Applications**, click **Register your Application**, name it "Neo", agree to the terms and click **Register Application**. Glass shows the API key.

**3. Give it access**

Open the application's **API Access** tab. Give it at least **Read** on **Domains** and **Account**, which the renewal notifications and the client mapping need. Give **Read / Write** where agents should make changes, and Read on each other service your agents should see, such as SafeDNS, eCloud or PSS. Click **Update Permissions**.

ANS lets the key reach only the services you gave it. A call to any other service gets a refusal from ANS, and the agent tells you which access it needs.

## 2. Add the key in Neo

**1. Open Integrations**

In the Neo Dashboard, open **Integrations** and find the ANS card, under Servers & Virtualization.

**2. Save the key**

Paste the **API Key** and click **Save**. Neo reads one domain and one client with it before saving, so a wrong key, or one without Read on Domains and Account, is reported straight away.

Neo then lists your ANS clients and suggests the PSA company for each on the **Organization Mapping** tab. Confirm them there before agents use a client on a ticket.

## 3. Turn ANS on per agent

Open the agent, go to the **Tools & Settings** tab, and configure the ANS block under **Tools & Integrations**. Pick a profile, or set each area:

| Area | Notes |
| - | - |
| **Domains** | Renewal and expiry dates, auto-renew and client of each domain. Needed for renewal notifications. Helpdesk asks before a change. |
| **Nameservers and Registrant** | Moving a domain to other nameservers, or changing its registrant. IT Admin asks. |
| **Registration and Renewal** | Renewal prices; registering and renewing, which ANS charges for and does not refund. IT Admin asks. |
| **Clients and Account** | Your ANS clients and contacts. IT Admin asks before a change. |
| **Billing** | Invoices and costs. IT Admin asks before a change. |
| **SafeDNS** | DNS records. Helpdesk asks before a change. |
| **SSL Certificates** | Certificates and their expiry. |
| **eCloud Servers and Storage** | Instances, volumes and images. |
| **eCloud Networking and Security** | Firewalls, networks, public IPs, VPNs and SSH keys. IT Admin asks. |
| **DDoSX and WAF** | DDoSX domains, WAF and ACL rules. IT Admin asks. |
| **Load Balancers** | Clusters, listeners and targets. |
| **Managed Cloudflare** | Cloudflare accounts and zones. IT Admin asks. |
| **Support Cases** | Cases with ANS. Helpdesk opens and updates them on its own. |
| **Monitoring** | Monitoring and threat monitoring. |
| **Disaster Recovery (DRaaS)** | DRaaS solutions and failover plans. IT Admin asks. |

Each area can be Disabled, Read Only or Read/Write.

**Always asks.** Whatever an area's approval setting, Neo asks a technician before it cancels a domain, changes a domain's registrant or moves it to another client, deletes a client, removes or loosens a domain's DDoSX protection (removes the domain, its WAF, its HSTS or its traffic through DDoSX, or changes its WAF settings, rulesets or GeoIP mode), decrypts or unlocks an eCloud instance, adds a member to or deletes a Cloudflare account, or changes a threat monitoring agent.

Neo never reads or sends a password, a VPN pre-shared key or a private key, and never opens an instance's console: a technician does those in Glass.

See [ANS API](https://docs.neoagent.io/agents/tools/networking/ans-api.md) for what the agent can do.

## Set up an agent

Ask your Neo Support Agent for the agent you need, for example: "Set up a scheduled agent that runs every Monday and checks our ANS domains: list the domains that renew or expire in the next 30 days, flag those with auto-renew off with their renewal price, and send the list to our team in Teams."


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.