Example curl request

curl --request GET \
     -x "http://proxy.geonode.io:<port>" \
     --user "<geonode_username>-session-<session_id>-lifetime-<lifetime>:<geonode_password>" \
     --url "http://ip-api.com/json"

{
  "status": "success",
  "continent": "Africa",
  "continentCode": "AF",
  "country": "Algeria",
  "countryCode": "DZ",
  "region": "05",
  "regionName": "Batna",
  "city": "Batna City",
  "district": "",
  "zip": "05000",
  "lat": 35.5064,
  "lon": 6.0707,
  "timezone": "Africa/Algiers",
  "offset": 3600,
  "currency": "DZD",
  "isp": "4 djaweb de AS fawri",
  "org": "",
  "as": "AS36947 Telecom Algeria",
  "asname": "ALGTEL-AS",
  "mobile": false,
  "proxy": false,
  "hosting": false,
  "query": "192.168.1.1"
}

Sticky Sessions Control

Configuring Proxy Session ID & Lifetime

Controlling the duration of your proxy sessions is essential for efficient and secure internet usage.
By creating sessions and providing lifetimes, you can set how long each connection lasts, ensuring uninterrupted and secure activities.
This feature aids in resource management, privacy maintenance, and overall performance enhancement.

Understanding the `lifetime` Parameter

Lifetime Constraints

Minimum lifetime: 3 minutes
Maximum lifetime: 1440 minutes (24 hours)
Default lifetime: 10 minutes

The lifetime parameter is measured in minutes. This defines how long the resource remains valid before it expires.

Examples:

lifetime: 5 → 5 minutes
lifetime: 30 → 30 minutes
lifetime: 60 → 1 hour
lifetime: 180 → 3 hours (since 3 hours = 180 minutes)

Custom Session ID Rules

Your custom session ID must follow a simple set of rules to be valid. Think of these rules as guidelines to ensure the string is clean, consistent,
and machine-readable.

Start with a Valid Character:

The first character must be one of the following:

An uppercase letter (A-Z)
A lowercase letter (a-z)
A digit (0-9)
An underscore (_)

Character Length:

The allowed characters can be repeated, but the total length must be between 1 and 25 characters.
This provides enough space for descriptive IDs while avoiding overly lengthy names.

No Extra Characters:

The string must end immediately after these 1 to 25 characters.
It cannot contain spaces or special symbols before or after the allowed characters.

Simplified Explanation

In simpler terms:

The session ID must be composed entirely of 1 to 25 alphanumeric characters or underscores (_).

If you’re familiar with regular expressions (regex), here’s what it looks like:

^[A-Za-z0-9_]{1,25}$

This regex ensures:

The string starts with a valid character.
It contains only valid characters throughout.
It ends precisely within the specified range of 1 to 25 characters.

Example curl request

curl --request GET \
     -x "http://proxy.geonode.io:<port>" \
     --user "<geonode_username>-session-<session_id>-lifetime-<lifetime>:<geonode_password>" \
     --url "http://ip-api.com/json"

{
  "status": "success",
  "continent": "Africa",
  "continentCode": "AF",
  "country": "Algeria",
  "countryCode": "DZ",
  "region": "05",
  "regionName": "Batna",
  "city": "Batna City",
  "district": "",
  "zip": "05000",
  "lat": 35.5064,
  "lon": 6.0707,
  "timezone": "Africa/Algiers",
  "offset": 3600,
  "currency": "DZD",
  "isp": "4 djaweb de AS fawri",
  "org": "",
  "as": "AS36947 Telecom Algeria",
  "asname": "ALGTEL-AS",
  "mobile": false,
  "proxy": false,
  "hosting": false,
  "query": "192.168.1.1"
}

Response

Proxy session created successfully with the specified lifetime.

status

string

Indicates the status of the request.

Example:

"success"

continent

string

The continent where the IP is located.

Example:

"Africa"

continentCode

string

The two-letter continent code.

Example:

"AF"

country

string

The full name of the country.

Example:

"Algeria"

countryCode

string

The two-letter country code.

Example:

"DZ"

region

string

The region code.

Example:

"05"

regionName

string

The full name of the region.

Example:

"Batna"

city

string

The name of the city.

Example:

"Batna City"

district

string

The district name, if available.

Example:

""

zip

string

The postal code associated with the IP.

Example:

"05000"

lat

number

The latitude coordinate.

Example:

35.5064

lon

number

The longitude coordinate.

Example:

6.0707

timezone

string

The timezone of the IP location.

Example:

"Africa/Algiers"

offset

integer

The time offset in seconds from UTC.

Example:

3600

currency

string

The currency code of the country.

Example:

"DZD"

isp

string

The name of the Internet Service Provider.

Example:

"4 djaweb de AS fawri"

org

string

The organization that owns the IP address, if available.

Example:

""

string

The Autonomous System (AS) number.

Example:

"AS36947 Telecom Algeria"

asname

string

The name associated with the AS number.

Example:

"ALGTEL-AS"

mobile

boolean

Indicates whether the connection is from a mobile network.

Example:

false

proxy

boolean

Indicates whether the IP is a known proxy.

Example:

false

hosting

boolean

Indicates whether the IP is from a hosting provider.

Example:

false

query

string

The queried IP address.

Example:

"192.168.1.1"

Create a New Sticky Session List All Active Sessions

Getting Started

Available Geo-Locations

Sticky Sessions Control

Usage Stats

Geo-Targetting

Exclude-Targetting

Proxy IP Type Filtering

IP Whitelist

Configuring Proxy Session ID & Lifetime

Understanding the `lifetime` Parameter

Lifetime Constraints

Examples:

Custom Session ID Rules

Start with a Valid Character:

Character Length:

No Extra Characters:

Simplified Explanation

Response