/usr/include/KAccounts/getcredentialsjob.h is in libkaccounts-dev 4:17.12.3-0ubuntu1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 | /*************************************************************************************
* Copyright (C) 2013 by Alejandro Fiestas Olivares <afiestas@kde.org> *
* *
* This library is free software; you can redistribute it and/or *
* modify it under the terms of the GNU Lesser General Public *
* License as published by the Free Software Foundation; either *
* version 2 of the License, or (at your option) any later version. *
* *
* This library is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU *
* Library General Public License for more details. *
* *
* You should have received a copy of the GNU Library General Public License *
* along with this library; see the file COPYING.LIB. If not, write to *
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, *
* Boston, MA 02110-1301, USA. *
*************************************************************************************/
#ifndef GET_CREDENTIALS_JOB_H
#define GET_CREDENTIALS_JOB_H
#include "kaccounts_export.h"
#include <KJob>
#include <Accounts/Account>
namespace Accounts {
class Manager;
}
/**
* A KJob for obtaining user's credentials for the given Accounts::AccountId
*/
class KACCOUNTS_EXPORT GetCredentialsJob : public KJob
{
Q_OBJECT
public:
/**
* Constructs the job with auth method and mechanism coming from the service
* type. If no service type is specified, the default will be used
*
* @param id AccountId for which the credentials will be obtained
*/
explicit GetCredentialsJob(const Accounts::AccountId &id, QObject *parent = 0);
/**
* This version of the constructor allow passing specific auth method and mechanism
* for which we want the credentials
*
* For example some account has OAuth token and username-password credentials,
* by setting both method and mechanism to "password", only the password will be
* retrieved. Otherwise it depends on the passed serviceType - if there's no serviceType
* set, it will use the default service for the given AccountId and will obtain
* the credentials needed for that service
*
* @param id AccountId for which the credentials will be obtained
* @param authMethod Auth method for which the credentials will be obtained
* @param authMechanism Auth mechanism for which the credentials will be obtained
*/
GetCredentialsJob(const Accounts::AccountId &id, const QString &authMethod = QString(), const QString &authMechanism = QString(), QObject *parent = 0);
/**
* Starts the credentials job
*/
virtual void start();
/**
* Set service for which the auth method and mechanism will be selected
*
* @param serviceType Account's service type
*/
void setServiceType(const QString &serviceType);
/**
* The obtained credentials data
*
* This will be valid only after the job has finished
*
* @returns Map with the credentials
*/
QVariantMap credentialsData() const;
/**
* @returns Account id for which the credentials are obtained
*/
Accounts::AccountId accountId() const;
private:
class Private;
Private * const d;
Q_PRIVATE_SLOT(d, void getCredentials());
};
#endif //GET_CREDENTIALS_JOB_H
|