UnauthScout

UnauthScout は、GitHub や GitLab などの公開された開発者プラットフォームを対象とした、未認証の OSINT 偵察のための CLI ツールです。

一貫したインターフェースと正規化された JSON 出力契約を使用して、公開されているユーザーデータの収集を標準化します。

問題提起

公開された開発者プラットフォームは、認証を必要とせずに貴重な偵察データを公開しています。しかし、このデータはプロバイダー間で不整合であることが多く、プログラムから利用するのが困難です。

UnauthScout は、以下の方法でこの問題に対処します：

• 認証なしで公開 API を照会する
• 明示的なスキーマを使用してレスポンスを正規化する
• シンプルでスクリプトから扱いやすい CLI を提供する

特徴

• GitHub における未認証ユーザー偵察
• GitLab における未認証ユーザー偵察
• 明示的なスキーマで定義された正規化 JSON 出力
• デバッグとフィールド探索のための生出力モード
• モジュール式のプロバイダーベースのアーキテクチャ

非目標

• 認証またはトークンベースのアクセス
• レート制限の回避
• 非公開データや制限付きデータの収集
• プラットフォーム間の自動的な相関付けやエンリッチメント

要件

• Bash（POSIX 互換）
• curl
• jq

インストール

git clone https://github.com/rmottanet/unauthscout.git
cd unauthscout
chmod +x bin/unauthscout

使用方法

基本的な使用方法

unauthscout <username>

生出力（未処理の API レスポンス）

unauthscout <username> --raw

デフォルトでは、UnauthScout は schemas/ 配下の対応するスキーマに準拠した正規化 JSON を出力します。

出力契約

正規化された出力は JSON Schema によって定義されます：

• schemas/github_user.json
• schemas/gitlab_user.json

これらのスキーマは、すべての処理済み出力の**信頼できる情報源（source of truth）**であり、安定した予測可能なデータ構造を保証します。

プロジェクト構成

bin/        # CLI entry point and orchestration
lib/        # Provider integrations and parsing logic
schemas/    # Normalized data contracts (JSON Schema)
docs/       # Documentation as code
tests/      # Automated tests (optional)

設計原則

• デフォルトで未認証
• 暗黙の前提よりも明示的なデータ契約
• オーケストレーションとデータ取得の明確な分離
• 最小限の表面積、設計による拡張性