許可された IP(ホワイトリスト)
クライアント IP のホワイトリストを管理して、プロキシパッケージに認証できる対象を制限します。
GET /packages/{id}/allowed-ips
現在のホワイトリストを返します。空の場合、login + password を知る任意の IP が接続できます。
GET
/api/v1/packages/{id}/allowed-ipsresponse.json
{
"data": { "ips": ["203.0.113.7", "198.51.100.42"], "max": 5 },
"meta": { "version": "v1" }
}POST /packages/{id}/allowed-ips
IP(IPv4 または IPv6)をホワイトリストに追加。パッケージあたり最大 5 IP。既存なら 409、上限到達で 422。
POST
/api/v1/packages/{id}/allowed-ipsrequest.json
{ "ip": "203.0.113.7" }response.json
{
"data": { "ips": ["203.0.113.7", "198.51.100.42"] },
"meta": { "version": "v1" }
}DELETE /packages/{id}/allowed-ips/{ip}
IP をホワイトリストから削除。成功時 204、存在しなければ 404。
DELETE
/api/v1/packages/{id}/allowed-ips/{ip}注意
空でないホワイトリストはパスワード認証を無効化します:許可された IP のクライアントのみが接続可能、認証情報に関係なく。空に戻すとパスワード認証が再有効化されます。
コード例
allowed-ips.sh
# List
curl https://raxyproxy.com/api/v1/packages/12/allowed-ips \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
# Add
curl -X POST https://raxyproxy.com/api/v1/packages/12/allowed-ips \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"ip":"203.0.113.7"}'
# Remove
curl -X DELETE https://raxyproxy.com/api/v1/packages/12/allowed-ips/203.0.113.7 \
-H "Authorization: Bearer raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"allowed-ips.py
import requests
API_KEY = 'raxy_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
PACKAGE_ID = 12
HEADERS = {'Authorization': f'Bearer {API_KEY}'}
BASE = f'https://raxyproxy.com/api/v1/packages/{PACKAGE_ID}/allowed-ips'
# Snapshot my current public IP into the whitelist
my_ip = requests.get('https://api.ipify.org').text
r = requests.post(BASE, headers=HEADERS, json={'ip': my_ip})
print(r.status_code, r.json())