Проверить Bearer-авторизацию API
Делает запрос с токеном из переменной окружения и не показывает сам токен.
Что делает скрипт
Скрипт проверяет защищённый эндпоинт, отправляя заголовок Authorization с Bearer-токеном. Токен берётся из API_TOKEN или флага --token и никогда не выводится в лог, показывается только длина. При 401 и 403 печатаются подсказки сервера, чтобы быстро найти проблему.
- Не храните реальный токен в истории команд, используйте переменную API_TOKEN.
Быстрый старт
python api_bearer.py http://127.0.0.1:8000/me --token demo
Скачайте файл, откройте терминал в папке со скриптом и выполните команду.
В Linux и macOS интерпретатор может называться python3, в Windows - python или py.
Другие варианты
set API_TOKEN=demo && python api_bearer.py http://127.0.0.1:8000/mepython api_bearer.py https://example.com/api/me --json
Что понадобится
winget install Python.Python.3.12
brew install python
sudo apt install python3
api_bearer.py
#!/usr/bin/env python3
"""Проверка Bearer-авторизации без вывода токена."""
from __future__ import annotations
import argparse
import json
import os
from urllib.error import HTTPError, URLError
from urllib.request import Request, urlopen
def main() -> int:
parser = argparse.ArgumentParser(description="Проверить Bearer-авторизацию")
parser.add_argument("url", nargs="?", default="http://127.0.0.1:8000/me", help="Защищённый эндпоинт")
parser.add_argument("--token", help="Токен, лучше задать через API_TOKEN")
parser.add_argument("--timeout", type=float, default=10.0)
parser.add_argument("--json", action="store_true", help="Показать ответ как JSON")
args = parser.parse_args()
token = args.token or os.environ.get("API_TOKEN", "")
if not token:
parser.error("Нет токена: задайте API_TOKEN или --token")
request = Request(
args.url,
headers={
"Authorization": f"Bearer {token}",
"Accept": "application/json, */*;q=0.8",
"User-Agent": "popovdev-scriptdock/1.0",
},
)
try:
with urlopen(request, timeout=args.timeout) as response:
status = response.status
body = response.read(1_000_000)
headers = dict(response.headers)
except HTTPError as error:
status = error.code
body = error.read(1_000_000)
headers = dict(error.headers) if error.headers else {}
except URLError as error:
print(f"Не удалось подключиться: {error.reason}")
return 2
print(f"URL: {args.url}")
print(f"Токен: {len(token)} символов, значение скрыто")
print(f"Статус: {status}")
if status == 401:
print("Ответ 401: токен отсутствует, просрочен или неверен.")
elif status == 403:
print("Ответ 403: токен принят, но прав на ресурс нет.")
challenge = ""
for key, value in headers.items():
if key.lower() == "www-authenticate":
challenge = value
break
if challenge:
print(f"WWW-Authenticate: {challenge}")
text = body.decode("utf-8", errors="replace")
if args.json:
try:
print(json.dumps(json.loads(text), ensure_ascii=False, indent=2)[:8000])
except json.JSONDecodeError:
print("Ответ не является JSON")
print(text[:1000])
else:
print(text[:2000])
return 0 if status not in {401, 403} and status < 400 else 1
if __name__ == "__main__":
raise SystemExit(main())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.