HTMLDialog - make a get request with Authentication header

Hi, my question would be the following. What should i do, if i want to make a request on a URL that needs the basic auth header to give back HTML result? I’m trying to use the UI::HTMLDialog.


Read up on using the Ruby standard library …

Then you might adapt it to using the newer SketchUp API classes …

References that help …

(IETF) RFC7617 : The ‘Basic’ HTTP Authentication Scheme

The HtmlDialog (which should be called HTMLDialog by Ruby naming conventions, but sadly isn’t) doesn’t have this built in. Using the Http module as Dan suggest is probably the best. Then you could use the HtmlDialog#set_html method to display the content loaded from the server in the HtmlDialog.

Also note that sending user and password embedded in the URI is supported by the Ruby library, but is deprecated by the W3C.

ie, ""

So some browsers no longer support it. You’d have to check if Chromium does or not.

EDIT: URI embedded credentials looks like it was dropped from Chrome ~2012 and from Internet Explorer prior to that. There were serious security flaws in this method. So it is a good idea to use the example I give below.

1 Like

Here is an untested example …

ADD: The example(s) below have been simplified per …

  • You could probably drop the dialog argument and just use self within the methods (which refers to the instance itself within instance methods. (The example was adapted from some other old code examples.)

… and are available here:

Older complex example ( to expand...)
module SomeAuthor::SomePlugin

  AuthDialog = defined?(UI::HtmlDialog) ? UI::HtmlDialog : UI::WebDialog )
  class AuthDialog

    # (IETF) RFC7617 : The ‘Basic’ HTTP Authentication Scheme

    if self < UI::WebDialog
      # using the Standard Ruby Library Net::HTTP classes ...
      require 'net/http' # loads 'uri'

      def get_page(dialog, url, username, password, **form)

        fail(ArgumentError, "username cannot contain a colon!",caller) if username.include?(':')

        uri = URI(url)
        req =
        req.basic_auth(username, password)

        UI.start_timer(0,false) do
          @res = Net::HTTP.start(uri.hostname, uri.port) {|http|
            http.request(req) do |response|
     if !dialog.visible?


      # using the SketchUp Ruby API HTTP classes v2017+ ...
      require 'uri'
      require 'base64'

      def get_page(dialog, url, username, password, **form)

        fail(ArgumentError, "username cannot contain a colon!",caller) if username.include?(':')

        uri = URI(url)
        creds = "#{username}:#{password}"

        @req =, Sketchup::Http::GET)
        @req.headers= { 'Authorization' => 'Basic '<< Base64.encode64(creds) }
        @req.body= URI.encode_www_form(form)

        @req.start do |request, response|
 if !dialog.visible?



  end # class AuthDialog
end # module namespaces

… and a call to the method would be like …

  dlg, "",
  'somebody', 'suchandsuch',
  'search' => 'some_query', 'lang' => Sketchup.get_locale

* … of course the form data fields can be whatever they need to be for the target webpage.

Thank you for the answers. Yes i knew, that this was an option, i just thought maybe i’m missing something. I’m not trying to use basic auth, it’s just an authentication header with an AccessToken, so that’s not gonna be a problem. Using a standard HTTP client, is not the same as a browser as far as i know.
I’m gonna try to make it work like this, thank you again for the advice.

Maybe a follow up question if i may, what’s the advantage of using the sketchup HTTP API, instead of the Ruby std. lib?

1 Like

Thank you very much, for answering my question.

1 Like

Well you said that in the first post unless you meant “plain-Jane” instead of “Basic” … so that is what we gave answers toward. (No biggie.)

Okay, then what I did not show above was that the standard Net::HTTP library makes it really easy to set and get headers for requests and response objects. Both classes (and their subclasses) have defined shortcut [] methods. Ie …

request["Access-Token"]= "QWxhZGRpbjpPcGVuU2VzYW1l"

… or …

if response["Cache-Control"] == "no-cache" then # do something ...

Thomas of the SketchUp Extensibility Team gives a quick answer in a issue thread from last week in the official API public issue tracker …

Thanks again. Yes i know i wrote that, i wasn’t trying to blame you for answering what i asked, i just realized it after, that i asked the wrong question.

1 Like

This topic was automatically closed 91 days after the last reply. New replies are no longer allowed.