The Close() method

Close ();

Closes the authenticator request to which this object refers and ends all related user interaction (dialogs, webflows etc).

A Response signal with the cancelled response will be emitted if the operation was cancelled. There is still a posibility of a race, so the operation might succeed or fail before processing the close request, so there is no guarantee that the operation will be cancelled.

The BasicAuthReply() method

BasicAuthReply (IN  s     user,
                IN  s     password,
                IN  a{sv} options);

Call to finish the request started with the BasicAuth signal.

The "Webflow" signal

Webflow (s     uri,
         a{sv} options);

Emitted by the authenticator when it needs to do web-based interaction. The client handles this by showing the URI in a graphical web view. Typically the uri includes information about a final redirect to a localhost uri that will happen when the operation is finished allowing the authenticator to get the result of the operation. This is similar to how OAUTH2 webflows typically work.

If at any point the user closes or otherwise dismisses the web view the client should call the org.freedesktop.Flatpak.AuthenticatorRequest.Close method to tell the authenticator that the operation is aborted.

The "WebflowDone" signal

WebflowDone (a{sv} options);

Emitted by the authenticator when the web view is done, at this point the client can close the WebView.

The "BasicAuth" signal

BasicAuth (s     realm,
           a{sv} options);

Emitted by the authenticator when it needs to do a simple user + password authentication. This is only useful for very simple authentication interaction, but this is still used (for instance for http basic access authentication), and for those cases this allows a nicely integrated UI and CLI experience.

The "Response" signal

Response (u     response,
          a{sv} results);

Emitted when the user interaction for a portal request is over. The response indicates how the user interaction ended:

In the case of an error (response 2) results can contain a error-message value describing what went wrong.