yunufeNetwork — 云南财经大学 校園網 静默ログインツール

Tool

概要

云南财经大学のキャンパスネットワーク(学内認証ポータル)に対して、ブラウザを起動せずに自動で認証処理を行うPythonベースのツールです。ユーザーは設定ファイル(config.json)に学籍番号やパスワード、接続タイプ(教学/宿舎)や認証サーバーのアドレスを記述するだけで、一括してログイン可能。ローカルのIPやMACアドレスを自動取得して認証リクエストを組み立てるため、手動操作を減らし時間と操作コストを削減します。exe形式の配布もあり、非技術ユーザーでも簡単に使えます。

GitHub

リポジトリの統計情報

  • スター数: 2
  • フォーク数: 0
  • ウォッチャー数: 2
  • コミット数: 6
  • ファイル数: 7
  • メインの言語: Python

主な特徴

  • ブラウザを開かずに「静默ログイン」を実行できる(自動認証)。
  • config.jsonでユーザー情報と接続種別を指定するだけの簡単操作。
  • ローカルのIPアドレスとMACアドレスを自動取得して認証リクエストに利用。
  • 教学/办公(学内)と宿舍/住宅(寮)向けの接続タイプをサポート。exe配布で手軽に利用可能。

技術的なポイント

本プロジェクトはPythonで実装されており、リポジトリ構成やREADMEの記述から、ネットワーク認証ポータルに対するHTTPベースのログインフローを自動化する典型的なアプローチを採用していると推察できます。具体的には、以下の点が技術的に注目できます。

  • 自動情報収集: ローカルマシンのIPアドレスとMACアドレスを取得してログイン時のパラメータに埋め込む点は、学内認証システムが接続元情報を検証する仕様に合わせた実装です。これにより、手動入力やブラウザの操作を不要にします。
  • 設定駆動: config.jsonにユーザー名・パスワード・domain(上網タイプ)・service_ip・ac_idなどを記述することで、実行時にそのまま認証リクエストを組み立てる構造になっています。これにより複数端末や利用シーンでの再利用が容易です。
  • クライアント→サーバー通信: READMEの例にあるservice_ipやac_idは、認証サーバーのエンドポイントや認証コンテキストを指定するためのものです。スクリプトはHTTPリクエスト(POST/GET)を用いて認証APIにアクセスし、サーバーの応答に応じてログイン成功/失敗を判定する実装が想定されます。
  • 実行環境と配布: exe版が配布されている点から、PyInstaller等でPythonスクリプトをスタンドアロン実行ファイルに変換しており、Python環境がない利用者でも使える配慮があります。一方で、exeとconfig.jsonを同一ディレクトリに置く運用ルールがREADMEに明示されており、運用上の手順が簡潔です。
  • セキュリティ面の注意点: パスワードを平文のJSONに保存する設計は利便性が高い一方で、ファイルアクセス権限や保管場所の管理を厳格にする必要があります。改良案としては、OSのシークレットストアや環境変数、暗号化した設定ファイルを使うことでリスクを低減できます。

総じて、本リポジトリは実用性・簡便性を重視したクライアントサイドの自動認証ツールであり、学内ネットワークの挙動(IP/MACによる認証や接続タイプの違い)に対応する設計が特徴です。利用時は学内の利用規約やセキュリティポリシーに従うことが重要です。

プロジェクトの構成

主要なファイルとディレクトリ:

  • .gitattributes: file
  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • config.json.example: file

…他 2 ファイル

(注:リポジトリは小規模で、実行用スクリプトやビルドされたexe、設定例が中心です)

使い方(README抜粋に基づくポイント)

  • exe版推奨:配布されているexeと同じフォルダにconfig.jsonを作成して実行するだけでログインできます。
  • config.jsonの必須フィールド:username(学籍番号)、password、domain(1- @ynufe または 2- @ctc)、service_ip(認証サーバーURL)、ac_id(識別子)。
  • domainの指定により教学/办公(学内)と宿舍/住宅(寮)向けの認証パラメータが切り替わる想定。
  • 実行前にネットワークに接続されていること、設定ファイルの内容が正しいことを確認してください。

セキュリティと運用上の注意

  • config.jsonに平文でパスワードを保存する設計なので、ファイルのパーミッションを適切に設定し第三者が閲覧できないようにしてください。
  • 学内ネットワークの利用規約に違反する使い方(複数アカウントの大量ログインなど)を避けること。
  • 将来的には資格情報をOSシークレットストアに移行する、または設定ファイルを暗号化することを検討してください。

まとめ

使いやすさを重視した学内自動ログインツールで、簡単な設定で静默ログインを実現できる点が優れています。

リポジトリ情報:

READMEの抜粋:

校园网静默登录工具

云南财经大学校园网自动登录工具,无需打开浏览器即可完成认证。

功能特点

  • ✅ 静默登录,无需打开浏览器
  • ✅ 支持配置文件,一键登录
  • ✅ 自动获取本机IP和MAC地址
  • ✅ 支持 教学/办公 和 宿舍/住宅 两种上网类型

📦 EXE 版本使用教程(推荐)

第一步:准备配置文件

在 exe 文件所在目录下,创建一个名为 config.json 的文件,内容如下:

{
  "username": "你的学号",
  "password": "你的密码",
  "domain": "1- @ynufe",
  "service_ip": "http://xxx 校园网ip",
  "ac_id": 7
}

配置说明:

  • username: 你的学号
  • password: 你的密码
  • domain: 上网类型
    • 1- @ynufe:教学/办公上网
    • 2- @ctc:宿舍/住宅上网
  • service_ip: 校园网服务器地址(xxx改为…