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

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"

200

{
  "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

200

application/json

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:

""

as · 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"