GitHub Enterprise Server・REST と GraphQL API・2026年10月25日に確認

GitHub Enterprise Server：つながらなかった理由

GitHub Enterprise Server では、REST の API は http(s)://HOSTNAME/api/v3、GraphQL の API は http(s)://HOSTNAME/api/graphql にあります（HOSTNAME はサーバーの名前）。GitHub.com では api.github.com です。サーバーにつながらない原因の多くは、住所・証明書・間のネットワークです（2026年10月25日に確認）。

PKIX path building failed: … unable to find valid certification path to requested target

何が起きているか、その理由

違う住所は 404：REST の道は /api/v3 の後ろに続き、GraphQL は /api/graphql の1つの住所です。2026年の公開の報告は、ある道具が GraphQL を HOST/api/graphql/graphql に送り、すべての呼び出しが 404 になったのを見ています。その道具のライブラリは、/api/v3 で終わる住所だけを /api/graphql に直し、それ以外には /graphql を足していました。
データの代わりに Web ページ：API でない住所（たとえば /api/v3 を付けずに、サーバーの Web の住所に API の道を続けたもの）は、JSON ではなく HTML のページで答えます。
証明書：GitHub の文書は、サーバーを初めて起動したとき TLS は自己署名の証明書で設定され、Web ブラウザーと Git のクライアントはそれを信頼せず、TLS を切るか信頼できる認証局（Let's Encrypt など）の証明書を上げるまで警告すると書いています。社内の認証局が署名した証明書には、そのルートと中間の証明書を入れる必要があります。証明書を信頼しない Java のプログラムは javax.net.ssl.SSLHandshakeException と「PKIX path building failed … unable to find valid certification path to requested target」で止まります。2023年の公開の報告は、Java で動く IDE から GitHub Enterprise Server につなぐときにこれに当たっています。

直し方

住所を確かめる：道具が自分で /api/v3 を足すならサーバーの Web の住所（https://HOSTNAME）を、API の根元を求められたときだけ https://HOSTNAME/api/v3 を渡します。curl -i https://HOSTNAME/api/v3/meta が Web ページでなく JSON で答えれば、住所は合っています。
証明書：サーバーの管理者に信頼できる認証局の証明書を頼むか、署名した社内の認証局を自分のコンピューターに信頼させます。
社内のネットワークの中なら：先にそこへつなぐ（VPN など）か、いる場所から API に届くかを管理者に聞きます。
つながったが断られた：401「Bad credentials」か「Resource not accessible by personal access token」へ。

IntelliJ IDEA の「Server is unreachable」と「Invalid authentication data.」

IntelliJ IDEA に入っている GitHub の機能のソース（2026年10月30日に確認・IntelliJ IDEA：GithubServerPath.java・GHTokenCredentialsUi.kt・GithubApiRequestExecutor.kt・GHEServerVersionChecker.kt・GHAPIExceptionUtil.kt）では：

住所：トークンでのログインの Server の欄はサーバーの Web の住所を取り、スキームを書かなければ https になります。IntelliJ IDEA は入れた住所の後ろに、パスも含めてそのまま、REST なら /api/v3、GraphQL なら /api/graphql を足します。そのため欄に https://HOSTNAME/api/v3 と入れると https://HOSTNAME/api/v3/api/v3 になり、上の「違う住所」になります。https://HOSTNAME と入れます。github.com と .ghe.com で終わる住所では、代わりにホストの前に api. を付けます。
ログインのとき：知らないホスト名なら「Server is unreachable」（サーバーに届かない）。それ以外の失敗は、違う住所からの 404 も含めて、「Invalid authentication data.」（認証のデータが正しくない）とその失敗自身の文になります。トークンが原因でなくてもそう出ます。
版：答えの x-github-enterprise-version が 3.2 より古いと、「Unsupported GitHub Enterprise server version X.Y. Earliest supported version is 3.2」（対応していない版。対応は 3.2 から）で止まります（ログインのときは「Invalid authentication data.」の後に出ます）。
Pull Requests のツールウィンドウでは、知らないホストは「Unknown host: HOSTNAME」と出ます。

IntelliJ IDEA で GitHub のプルリクを見るなら

Lesstep の Pull Request Inbox for GitHub は、JetBrains IDE（2024.1 以降）のプラグインです。設定の GitHub Enterprise の住所はサーバーの Web の住所として受け取り、貼られた /api/v3 や /api/graphql は自分で外します。REST は /api/v3、GraphQL は /api/graphql に送り（GHE.com の住所なら前に api. を付けます）、トークンはその住所にだけ送ります。通信は IDE のプロキシと証明書の設定（OS の証明書ストア・Server Certificates（IDE 2025.2 からは Settings | Appearance & Behavior | System Settings、それより前は Settings | Tools・JetBrains の説明「Server Certificates」）で受け入れた証明書・信頼できない証明書のときの IDE の確認）を通ります。サーバーが Web ページで答えたらそう言って設定の住所を指し、別のホストへの転送はたどらずに行き先を出し、サーバーの証明書を IDE が信用していないとき（「PKIX path building failed」・名前が合わないなど）はそう言って、受け入れる・IDE の設定の Server Certificates に加える・会社のルート証明書を OS に信頼させる、を案内します。ほかの理由でつながらないときは Java の理由を添えてそう言います。受信箱・差分・会話は無料、承認・コメント・マージは Pro（月 US$1.50・30日間の無料試用つき）です。画面は日本語です。

GitHub は GitHub, Inc. の商標、IntelliJ IDEA は JetBrains s.r.o. の商標です。このページは GitHub, Inc.・JetBrains のいずれとも提携しておらず、承認も受けていません。