Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Cannot use cross reference services (xrefService) behind Proxy Server #3597

Closed
tibel opened this issue Nov 8, 2018 · 4 comments
Closed

Cannot use cross reference services (xrefService) behind Proxy Server #3597

tibel opened this issue Nov 8, 2018 · 4 comments
Labels
xref Cross reference another document using unique IDs

Comments

@tibel
Copy link
Contributor

tibel commented Nov 8, 2018

DocFX Version Used: 2.40.1

Template used: statictoc

Steps to Reproduce:

  1. build machine is behind corporate proxy server
  2. add "xrefService": [ "https://xref.docs.microsoft.com/query?uid={uid}" ] to doxfx.json
  3. build documentation

Expected Behavior:
Cross references should be resolved.

Actual Behavior:

[18-11-08 03:02:35.900]Info:[BuildCommand.BuildCore.Build Document.LinkPhaseHandlerWithIncremental.UpdateContext]Unable to resolve uid (System.AttributeUsageAttribute) from https://xref.docs.microsoft.com/query?uid={uid}, details: An error occurred while sending the request.

Is there something I can do to get a more detailed error message?

@herohua
Copy link
Contributor

herohua commented Nov 19, 2018

@superyyrrzz , can you help reply possible workarounds here?

@superyyrrzz
Copy link
Contributor

@tibel DocFX does not support proxy server configuration for now. Could you try some proxy client software to forward local machine network globally to proxy server? e.g. https://www.proxifier.com/ (I just googled it and have not used it).

@tibel
Copy link
Contributor Author

tibel commented Nov 20, 2018

@superyyrrzz Thanks for the hint. I used https://www.telerik.com/fiddler to track it down. Our company proxy requires authentication, so DocFX gets a http 407 response.

Feature Request:
Maybe the console logging output of DocFX can be extended to show more info on what went wrong.

@stale
Copy link

stale bot commented Mar 6, 2019

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs.

@stale stale bot added the stale label Mar 6, 2019
@stale stale bot removed the stale label Mar 7, 2019
@superyyrrzz superyyrrzz added the xref Cross reference another document using unique IDs label Mar 7, 2019
@yufeih yufeih closed this as not planned Won't fix, can't repro, duplicate, stale Apr 12, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
xref Cross reference another document using unique IDs
Projects
None yet
Development

No branches or pull requests

4 participants