feat(utils): Pass a URL to the Authenticator if available

That way, the `Authenticator` can evaluate all information available
in the URL.

Signed-off-by: Oliver Heger <oliver.heger@bosch.com>

Author: oheger-bosch

utils/ort/src/main/kotlin/Utils.kt

@@ -23,6 +23,7 @@ import java.io.File
 import java.net.Authenticator
 import java.net.PasswordAuthentication
 import java.net.URI
+import java.net.URL
 
 import kotlin.coroutines.CoroutineContext
 import kotlin.coroutines.EmptyCoroutineContext
@@ -120,10 +121,10 @@ fun filterVersionNames(version: String, names: List<String>, project: String? =
 }
 
 /**
- * Request a [PasswordAuthentication] object for the given [host], [port], and [scheme]. Install the [OrtAuthenticator]
- * and the [OrtProxySelector] beforehand to ensure they are active.
+ * Request a [PasswordAuthentication] object for the given [host], [port], [scheme], and optional [url]. Install the
+ * [OrtAuthenticator] and the [OrtProxySelector] beforehand to ensure they are active.
  */
-fun requestPasswordAuthentication(host: String, port: Int, scheme: String): PasswordAuthentication? {
+fun requestPasswordAuthentication(host: String, port: Int, scheme: String, url: URL? = null): PasswordAuthentication? {
     OrtAuthenticator.install()
     OrtProxySelector.install()
 
@@ -133,7 +134,9 @@ fun requestPasswordAuthentication(host: String, port: Int, scheme: String): Pass
         /* port = */ port,
         /* protocol = */ scheme,
         /* prompt = */ null,
-        /* scheme = */ null
+        /* scheme = */ null,
+        /* url = */ url,
+        /* reqType = */ Authenticator.RequestorType.SERVER
     )
 }
 
@@ -142,7 +145,7 @@ fun requestPasswordAuthentication(host: String, port: Int, scheme: String): Pass
  * [OrtProxySelector] beforehand to ensure they are active.
  */
 fun requestPasswordAuthentication(uri: URI): PasswordAuthentication? =
-    requestPasswordAuthentication(uri.host, uri.port, uri.scheme)
+    requestPasswordAuthentication(uri.host, uri.port, uri.scheme, uri.toURL())
 
 /**
  * Normalize a string representing a [VCS URL][vcsUrl] to a common string form.

utils/ort/src/test/kotlin/UtilsTest.kt

@@ -444,7 +444,16 @@ class UtilsTest : WordSpec({
             val passwordAuth = mockk<PasswordAuthentication>()
 
             every {
-                Authenticator.requestPasswordAuthentication(host, null, port, scheme, null, null)
+                Authenticator.requestPasswordAuthentication(
+                    host,
+                    null,
+                    port,
+                    scheme,
+                    null,
+                    null,
+                    null,
+                    Authenticator.RequestorType.SERVER
+                )
             } returns passwordAuth
 
             requestPasswordAuthentication(host, port, scheme) shouldBe passwordAuth
@@ -455,6 +464,36 @@ class UtilsTest : WordSpec({
             }
         }
 
+        "return a correct authentication object for a URL" {
+            val url = URI.create("https://www.example.org:442/auth/test")
+
+            mockkObject(OrtAuthenticator)
+            mockkObject(OrtProxySelector)
+            mockkStatic(Authenticator::class)
+
+            val passwordAuth = mockk<PasswordAuthentication>()
+
+            every {
+                Authenticator.requestPasswordAuthentication(
+                    "www.example.org",
+                    null,
+                    442,
+                    "https",
+                    null,
+                    null,
+                    url.toURL(),
+                    Authenticator.RequestorType.SERVER
+                )
+            } returns passwordAuth
+
+            requestPasswordAuthentication(url) shouldBe passwordAuth
+
+            verify {
+                OrtAuthenticator.install()
+                OrtProxySelector.install()
+            }
+        }
+
         "return the credentials present in the URL if any" {
             val host = "www.example.org"
             val port = 442