> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/products/es/proxies/residential-proxies/whitelisting-ips.md).

# Lista blanca de IPs

Aprende a crear o editar una lista blanca de IPs para tus Residential Proxies.

La lista blanca de IP te permite acceder a nuestro pool de Residential Proxies simplemente conectándote mediante IPs en la lista blanca.

{% hint style="info" %}
Solo puede añadir IP que estén en formato IPv4 (xx.xx.xx.xx). Asegúrese de que la IP que está añadiendo sea suya y esté **no usando un servicio de Proxy o VPN** en ese momento.
{% endhint %}

## Crear una lista blanca de IP

Para incluir direcciones IP en la lista blanca, inicie sesión en el [**panel de control**](https://dashboard.oxylabs.io/), en el lado izquierdo seleccione **Residential Proxies** → **Lista blanca**, haga clic en **Editar lista blanca**. Introduzca **hasta 10 direcciones IP** en formato de texto y haga clic en Enviar.

{% hint style="info" %}
Si es importante distinguir las estadísticas de tráfico entre usuarios de proxy, recomendamos no usar la funcionalidad de IP en lista blanca, especialmente cuando la misma IP pública pueda compartirse entre usuarios del servicio (equipos, departamentos, etc.).

**Nota:** Si se usa un navegador o un Headless Browser, intentará usar el proxy sin autenticación normal y solo enviará la autenticación si recibe un `407`.
{% endhint %}

Si desea eliminar o actualizar la lista, edítela como un documento de texto y haga clic en **Enviar**. Si necesita más IP, póngase en contacto con nuestro equipo de atención al cliente en [**support@oxylabs.io**](mailto:support@oxylabs.io) o mediante el chat en vivo 24/7 en nuestro [**sitio web**](https://oxylabs.io/) o a su panel de Oxylabs. La lista blanca de IP te permite acceder a nuestro pool de Residential Proxies simplemente conectándote mediante IPs en la lista blanca.

## Solicitudes con IPs en la lista blanca

Con IPs en la lista blanca, puede acceder a Oxylabs Residential Proxies **sin necesidad de proporcionar un `username` y `password`**. Al incluir su dirección IP en la lista blanca, puede especificar todos los parámetros de su proxy **directamente en el subdominio.**

Si agrega una IP a la lista blanca, debe conectarse usando **ya sea la IP en la lista blanca o las credenciales**, pero no ambos, ya que hacerlo puede provocar un comportamiento inesperado.

### Ejemplo de código

Aquí hay un ejemplo de código que apunta a la ciudad de Nueva York con un ID de sesión dado:

{% tabs %}
{% tab title="cURL" %}

```shell
curl -x https://cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777 https://ip.oxylabs.io/location
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$session_id = 'test123';  // Your session ID
$city = 'new_york';  // The city you want to target
$proxy = "cc-us-city-$city-sessid-$session_id.bc.pr.oxylabs.io:7777";
$query = curl_init('https://ip.oxylabs.io/location');

curl_setopt($query, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($query, CURLOPT_PROXY, "http://$proxy");
$output = curl_exec($query);
curl_close($query);

if ($output)
    echo $output;
?>

```

{% endtab %}

{% tab title="Python" %}

```python
import urllib.request

session_id = 'test123'  # Your session ID
city = 'new_york'  # The city you want to target
proxy = 'cc-us-city-%s-sessid-%s.bc.pr.oxylabs.io:7777' % (city, session_id)

query = urllib.request.ProxyHandler({
    'http': proxy,
    'https': proxy,
})

execute = urllib.request.build_opener(query)
print(execute.open('https://ip.oxylabs.io/location').read())

```

{% endtab %}

{% tab title="Java" %}

```java
package example;

import org.apache.http.HttpHost;
import org.apache.http.client.fluent.*;

public class Example {
    public static void main(String[] args) throws Exception {
        HttpHost entry = new HttpHost("cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io", 7777);

        String query = Executor.newInstance()
            .execute(Request.Get("http://ip.oxylabs.io/location").viaProxy(entry))
            .returnContent().asString();
        
        System.out.println(query);
    }
}

```

{% endtab %}

{% tab title="C#" %}

```csharp
using System;
using System.Net;

class Example
{
    static void Main()
    {
        var client = new WebClient();
        
        client.Proxy = new WebProxy("cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777");

        Console.WriteLine(client.DownloadString("https://ip.oxylabs.io/location"));
    }
}

```

{% endtab %}

{% tab title="Go" %}

```ruby
package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
	"net/url"
)

func main() {
	proxyURL, _ := url.Parse("https://cc-us-city-new_york-sessid-test123.bc.pr.oxylabs.io:7777")
	client := &http.Client{Transport: &http.Transport{Proxy: http.ProxyURL(proxyURL)}}

	resp, err := client.Get("https://ip.oxylabs.io/location")
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	defer resp.Body.Close()

	body, _ := ioutil.ReadAll(resp.Body)
	fmt.Println(string(body))
}
```

{% endtab %}
{% endtabs %}

### **Parámetros de consulta**

| Parámetro    | Descripción                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cc`         | Código de país sin distinción de mayúsculas y minúsculas en formato de 2 letras [**3166-1 alfa-2**](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). Por ejemplo, `DE` para Alemania, `GB` para el Reino Unido, `TH` para Tailandia. Puedes encontrar más detalles sobre cómo usar proxies específicos de país [**aquí**](/products/es/proxies/residential-proxies/location-settings/select-country.md).                                                                                                                                                            |
| `ciudad`     | Nombre de ciudad sin distinción de mayúsculas y minúsculas en inglés. Este parámetro debe ir acompañado de `cc` para una mayor precisión, por ejemplo, `cc-GB-city-london` para Londres, Reino Unido; `cc-DE-city-berlin` para Berlín, Alemania. Para una ciudad con más de dos palabras, reemplaza el espacio por `_`, por ejemplo, `city-st_petersburg` o `city-rio_de_janeiro`. Haz clic [**aquí**](https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-city) para obtener más información sobre la segmentación a nivel de ciudad. |
| `st`         | Nombre de estado de EE. UU. sin distinción de mayúsculas y minúsculas con us\_ al principio, por ejemplo, `us_california`, `us_illinois`. [**Haz clic aquí** ](https://developers.oxylabs.io/proxies/residential-proxies/location-settings/select-state)para obtener más información sobre la segmentación a nivel de estado.                                                                                                                                                                                                                                         |
| `cn`         | Para obtener un proxy de cualquiera de los siete continentes, añade el `cn-` parámetro y código de dos letras a la cadena de autorización. Haga clic aquí para obtener más información sobre la segmentación a nivel de continente                                                                                                                                                                                                                                                                                                                                    |
| `postalcode` | <p>Para conectarse a un proxy usando un código postal, agregue y especifique el <code>postalcode</code> parámetro con un <strong>de cinco dígitos</strong> Código postal. Este parámetro debe usarse combinado con el parámetro del código de país <code>cc</code> y un código de país de 2 letras que no distingue mayúsculas y minúsculas <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2"><strong>3166-1 alfa-2</strong></a>.<br><a href="/products/es/proxies/residential-proxies/location-settings/zip-postal-code.md">Más información aquí.</a></p>   |
| `ASN`        | Puede elegir Proxies de operadores específicos. Debe introducir el número ASN requerido en su solicitud. Más información [**aquí**](/products/es/proxies/residential-proxies/location-settings/asn-targeting.md).                                                                                                                                                                                                                                                                                                                                                     |
| `sessid`     | ID de sesión para mantener la misma IP en consultas posteriores. La sesión expira en 10 minutos. Después de eso, se asigna una nueva dirección IP a ese ID de sesión. Se admiten cadenas aleatorias, 0-9 y caracteres A-Z.                                                                                                                                                                                                                                                                                                                                            |
| `sesstime`   | El parámetro de tiempo de sesión mantiene la misma IP durante un cierto período. El tiempo máximo de sesión es de 30 minutos.                                                                                                                                                                                                                                                                                                                                                                                                                                         |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.oxylabs.io/products/es/proxies/residential-proxies/whitelisting-ips.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.