include/ucbhelper/simpleauthenticationrequest.hxx

   1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
   2 /*
   3  * This file is part of the LibreOffice project.
   4  *
   5  * This Source Code Form is subject to the terms of the Mozilla Public
   6  * License, v. 2.0. If a copy of the MPL was not distributed with this
   7  * file, You can obtain one at http://mozilla.org/MPL/2.0/.
   8  *
   9  * This file incorporates work covered by the following license notice:
  10  *
  11  *   Licensed to the Apache Software Foundation (ASF) under one or more
  12  *   contributor license agreements. See the NOTICE file distributed
  13  *   with this work for additional information regarding copyright
  14  *   ownership. The ASF licenses this file to you under the Apache
  15  *   License, Version 2.0 (the "License"); you may not use this file
  16  *   except in compliance with the License. You may obtain a copy of
  17  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  18  */
  19
  20 #ifndef INCLUDED_UCBHELPER_SIMPLEAUTHENTICATIONREQUEST_HXX
  21 #define INCLUDED_UCBHELPER_SIMPLEAUTHENTICATIONREQUEST_HXX
  22
  23 #include <rtl/ref.hxx>
  24 #include <ucbhelper/interactionrequest.hxx>
  25 #include <ucbhelper/ucbhelperdllapi.h>
  26
  27 namespace com { namespace sun { namespace star { namespace ucb {
  28   class URLAuthenticationRequest;
  29 } } } }
  30
  31 namespace ucbhelper {
  32
  33 /**
  34   * This class implements a simple authentication interaction request.
  35   * Instances can be passed directly to XInteractionHandler::handle(...). Each
  36   * instance contains an AuthenticationRequest and three interaction
  37   * continuations: "Abort", "Retry" and "SupplyAuthentication". The parameters
  38   * for the AuthenticationRequest and the InteractionSupplyAuthentication
  39   * objects are partly taken from constructors parameters and partly defaulted
  40   * as follows:
  41   *
  42   * Read-only values : servername, realm
  43   * Read-write values: username, password, account
  44   * All remember-authentication values: RememberAuthentication_NO
  45   *
  46   * @see css::ucb::AuthenticationRequest
  47   * @see css::ucb::RememberAuthentication
  48   * @see InteractionAbort
  49   * @see InteractionRetry
  50   * @see InteractionSupplyAuthentication
  51   */
  52 class UCBHELPER_DLLPUBLIC SimpleAuthenticationRequest final : public ucbhelper::InteractionRequest
  53 {
  54     rtl::Reference<
  55         ucbhelper::InteractionSupplyAuthentication > m_xAuthSupplier;
  56
  57 private:
  58     void initialize( const css::ucb::URLAuthenticationRequest & rRequest,
  59                      bool bCanSetRealm,
  60                      bool bCanSetUserName,
  61                      bool bCanSetPassword,
  62                      bool bCanSetAccount,
  63                      bool bAllowUseSystemCredentials,
  64                      bool bAllowSessionStoring );
  65
  66 public:
  67     /** Specification whether some entity (realm, username, password, account)
  68         is either not applicable at all, has a fixed value, or is modifiable.
  69      */
  70     enum EntityType
  71     {
  72         ENTITY_NA,
  73         ENTITY_FIXED,
  74         ENTITY_MODIFY
  75     };
  76
  77     /**
  78       * Constructor.
  79       *
  80       * @param rURL contains a URL for which authentication is requested.
  81       * @param rServerName contains a server name.
  82       * @param rRealm contains a realm, if applicable.
  83       * @param rUserName contains a username, if available (for instance from
  84       *        a previous try).
  85       * @param rPassword contains a password, if available (for instance from
  86       *        a previous try).
  87       * @param bAllowUseSystemCredentials specifies if requesting client is
  88       *        able to obtain and use system credentials for authentication
  89       */
  90     SimpleAuthenticationRequest( const OUString & rURL,
  91                                  const OUString & rServerName,
  92                                  const OUString & rRealm,
  93                                  const OUString & rUserName,
  94                                  const OUString & rPassword,
  95                                  bool bAllowUseSystemCredentials,
  96                                  bool bAllowSessionStoring = true );
  97
  98
  99     /**
 100       * Constructor.
 101       *
 102       * @param rServerName contains a server name.
 103       * @param eRealmType specifies whether a realm is applicable and
 104                modifiable.
 105       * @param rRealm contains a realm, if applicable.
 106       * @param eUserNameType specifies whether a username is applicable and
 107                modifiable.
 108       * @param rUserName contains a username, if available (for instance from
 109       *        a previous try).
 110       * @param ePasswordType specifies whether a password is applicable and
 111                modifiable.
 112       * @param rPassword contains a password, if available (for instance from
 113       *        a previous try).
 114       */
 115     SimpleAuthenticationRequest( const OUString & rURL,
 116                                  const OUString & rServerName,
 117                                  EntityType eRealmType,
 118                                  const OUString & rRealm,
 119                                  EntityType eUserNameType,
 120                                  const OUString & rUserName,
 121                                  EntityType ePasswordType,
 122                                  const OUString & rPassword );
 123
 124     /**
 125       * This method returns the supplier for the missing authentication data,
 126       * that, for instance can be used to query the password supplied by the
 127       * interaction handler.
 128       *
 129       * @return the supplier for the missing authentication data.
 130       */
 131     const rtl::Reference< ucbhelper::InteractionSupplyAuthentication > &
 132     getAuthenticationSupplier() const { return m_xAuthSupplier; }
 133 };
 134
 135 } // namespace ucbhelper
 136
 137 #endif /* ! INCLUDED_UCBHELPER_SIMPLEAUTHENTICATIONREQUEST_HXX */
 138
 139 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */