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

# Whitelist Trusted SIP Sources with IP Mapping

> IP Mapping controls which SIP sources Ringingo accepts inbound traffic from. Whitelist carrier IPs and optionally add prefixes to inbound CLIs.

IP Mapping defines a whitelist of trusted IP addresses from which Ringingo accepts inbound SIP traffic. Any SIP INVITE arriving from an IP not in the mapping table is rejected at the platform perimeter, providing a first layer of inbound call security against unauthorised traffic.

## IP mapping list fields

| Field       | Description                                                                           |
| ----------- | ------------------------------------------------------------------------------------- |
| IP Address  | Authorised source IP or CIDR range for inbound SIP.                                   |
| Description | Internal label identifying the source (carrier name, SIP trunk provider, office PBX). |
| Status      | Toggle to enable or disable the entry.                                                |
| Actions     | Edit or delete.                                                                       |

<Warning>
  Only add IP addresses from verified and trusted SIP carriers or network sources. An incorrectly whitelisted IP may allow unauthorised SIP traffic to reach the platform, resulting in toll fraud or call spoofing.
</Warning>

## Create an IP mapping entry

<Steps>
  <Step title="Open the form">
    Click **+ Create IP Mapping**.
  </Step>

  <Step title="Add source IP and prefix">
    Enter the IP address or CIDR block, and an optional Set Prefix for inbound caller ID.
  </Step>

  <Step title="Enable">
    Set Status to Enable to activate the whitelist entry.
  </Step>
</Steps>

### Fields

| Field      | Required | Description                                                                                                                |
| ---------- | -------- | -------------------------------------------------------------------------------------------------------------------------- |
| IP         | Yes      | Source IP address or CIDR block (203.0.113.10 or 203.0.113.0/24).                                                          |
| Set Prefix | No       | Optional digit prefix to prepend to inbound caller ID for calls from this IP (for example, 971 to add a UAE country code). |
| Status     | Yes      | Enable to activate immediately.                                                                                            |

<Info>
  Every SIP carrier or trunk provider that sends inbound calls to Ringingo must have its source IP added here. If a carrier's IP is not in the IP Mapping table, calls from that source are silently rejected. Agents receive no inbound calls even if the DID and routing are configured correctly.
</Info>