Web и API

Проверить Bearer-авторизацию API

Делает запрос с токеном из переменной окружения и не показывает сам токен.

Python Windows macOS Linux Средний
Скачать api_bearer.py
Описание

Что делает скрипт

Скрипт проверяет защищённый эндпоинт, отправляя заголовок 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/me
  • python api_bearer.py https://example.com/api/me --json
Зависимости

Что понадобится

Python 3.10+ Интерпретатор Python
Windows winget install Python.Python.3.12
macOS brew install python
Linux 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())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get web-api-bearer-auth
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Web и API

HTTP, API, сайты, заголовки, SSL и проверка веб-сервисов.

Теги