/* * Copyright (C) 2010 Felix Geyer * Copyright (C) 2017 KeePassXC Team * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 2 or (at your option) * version 3 of the License. * * This program 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef KEEPASSX_ENTRY_H #define KEEPASSX_ENTRY_H #include #include #include #include "core/AutoTypeAssociations.h" #include "core/CustomData.h" #include "core/EntryAttachments.h" #include "core/EntryAttributes.h" #include "core/Global.h" #include "core/TimeInfo.h" class Database; class Group; class PasswordHealth; namespace Totp { struct Settings; } enum class EntryReferenceType { Unknown, Title, UserName, Password, Url, Notes, QUuid, CustomAttributes }; struct EntryData { int iconNumber; QUuid customIcon; QString foregroundColor; QString backgroundColor; QString overrideUrl; QString tags; bool autoTypeEnabled; int autoTypeObfuscation; QString defaultAutoTypeSequence; TimeInfo timeInfo; QSharedPointer totpSettings; QSharedPointer passwordHealth; bool excludeFromReports; QUuid previousParentGroupUuid; bool operator==(const EntryData& other) const; bool operator!=(const EntryData& other) const; bool equals(const EntryData& other, CompareItemOptions options) const; }; class Entry : public ModifiableObject { Q_OBJECT public: Entry(); ~Entry(); const QUuid& uuid() const; const QString uuidToHex() const; int iconNumber() const; const QUuid& iconUuid() const; QString foregroundColor() const; QString backgroundColor() const; QString overrideUrl() const; QString tags() const; const TimeInfo& timeInfo() const; bool autoTypeEnabled() const; int autoTypeObfuscation() const; QString defaultAutoTypeSequence() const; QString effectiveAutoTypeSequence() const; QList autoTypeSequences(const QString& pattern = {}) const; AutoTypeAssociations* autoTypeAssociations(); const AutoTypeAssociations* autoTypeAssociations() const; QString title() const; QString url() const; QString webUrl() const; QString displayUrl() const; QString username() const; QString password() const; QString notes() const; QString attribute(const QString& key) const; QString totp() const; QString totpSettingsString() const; QSharedPointer totpSettings() const; Group* previousParentGroup(); const Group* previousParentGroup() const; QUuid previousParentGroupUuid() const; int size() const; QString path() const; const QSharedPointer& passwordHealth(); bool excludeFromReports() const; void setExcludeFromReports(bool state); bool hasTotp() const; bool isExpired() const; bool isRecycled() const; bool isAttributeReference(const QString& key) const; bool isAttributeReferenceOf(const QString& key, const QUuid& uuid) const; void replaceReferencesWithValues(const Entry* other); bool hasReferences() const; bool hasReferencesTo(const QUuid& uuid) const; EntryAttributes* attributes(); const EntryAttributes* attributes() const; EntryAttachments* attachments(); const EntryAttachments* attachments() const; CustomData* customData(); const CustomData* customData() const; void setUuid(const QUuid& uuid); void setIcon(int iconNumber); void setIcon(const QUuid& uuid); void setForegroundColor(const QString& color); void setBackgroundColor(const QString& color); void setOverrideUrl(const QString& url); void setTags(const QString& tags); void setTimeInfo(const TimeInfo& timeInfo); void setAutoTypeEnabled(bool enable); void setAutoTypeObfuscation(int obfuscation); void setDefaultAutoTypeSequence(const QString& sequence); void setTitle(const QString& title); void setUrl(const QString& url); void setUsername(const QString& username); void setPassword(const QString& password); void setNotes(const QString& notes); void setDefaultAttribute(const QString& attribute, const QString& value); void setExpires(const bool& value); void setExpiryTime(const QDateTime& dateTime); void setTotp(QSharedPointer settings); void setPreviousParentGroup(const Group* group); void setPreviousParentGroupUuid(const QUuid& uuid); QList historyItems(); const QList& historyItems() const; void addHistoryItem(Entry* entry); void removeHistoryItems(const QList& historyEntries); void truncateHistory(); bool equals(const Entry* other, CompareItemOptions options = CompareItemDefault) const; enum CloneFlag { CloneNoFlags = 0, CloneNewUuid = 1, // generate a random uuid for the clone CloneResetTimeInfo = 2, // set all TimeInfo attributes to the current time CloneIncludeHistory = 4, // clone the history items CloneDefault = CloneNewUuid | CloneResetTimeInfo, CloneCopy = CloneNewUuid | CloneResetTimeInfo | CloneIncludeHistory, CloneRenameTitle = 8, // add "-Clone" after the original title CloneUserAsRef = 16, // Add the user as a reference to the original entry ClonePassAsRef = 32, // Add the password as a reference to the original entry }; Q_DECLARE_FLAGS(CloneFlags, CloneFlag) enum class PlaceholderType { NotPlaceholder, Unknown, Title, UserName, Password, Notes, Totp, Url, UrlWithoutScheme, UrlScheme, UrlHost, UrlPort, UrlPath, UrlQuery, UrlFragment, UrlUserInfo, UrlUserName, UrlPassword, Reference, CustomAttribute, DateTimeSimple, DateTimeYear, DateTimeMonth, DateTimeDay, DateTimeHour, DateTimeMinute, DateTimeSecond, DateTimeUtcSimple, DateTimeUtcYear, DateTimeUtcMonth, DateTimeUtcDay, DateTimeUtcHour, DateTimeUtcMinute, DateTimeUtcSecond, DbDir }; static const int DefaultIconNumber; static const int ResolveMaximumDepth; static const QString AutoTypeSequenceUsername; static const QString AutoTypeSequencePassword; /** * Creates a duplicate of this entry except that the returned entry isn't * part of any group. * Note that you need to copy the custom icons manually when inserting the * new entry into another database. */ Entry* clone(CloneFlags flags = CloneDefault) const; void copyDataFrom(const Entry* other); QString maskPasswordPlaceholders(const QString& str) const; Entry* resolveReference(const QString& str) const; QString resolveMultiplePlaceholders(const QString& str) const; QString resolvePlaceholder(const QString& str) const; QString resolveUrlPlaceholder(const QString& str, PlaceholderType placeholderType) const; QString resolveDateTimePlaceholder(PlaceholderType placeholderType) const; PlaceholderType placeholderType(const QString& placeholder) const; QString resolveUrl(const QString& url) const; /** * Call before and after set*() methods to create a history item * if the entry has been changed. */ void beginUpdate(); bool endUpdate(); void moveUp(); void moveDown(); Group* group(); const Group* group() const; void setGroup(Group* group, bool trackPrevious = true); const Database* database() const; Database* database(); bool canUpdateTimeinfo() const; void setUpdateTimeinfo(bool value); signals: /** * Emitted when a default attribute has been changed. */ void entryDataChanged(Entry* entry); private slots: void emitDataChanged(); void updateTimeinfo(); void updateModifiedSinceBegin(); void updateTotp(); private: QString resolveMultiplePlaceholdersRecursive(const QString& str, int maxDepth) const; QString resolvePlaceholderRecursive(const QString& placeholder, int maxDepth) const; QString resolveReferencePlaceholderRecursive(const QString& placeholder, int maxDepth) const; QString referenceFieldValue(EntryReferenceType referenceType) const; static QString buildReference(const QUuid& uuid, const QString& field); static EntryReferenceType referenceType(const QString& referenceStr); template bool set(T& property, const T& value); QUuid m_uuid; EntryData m_data; QPointer m_attributes; QPointer m_attachments; QPointer m_autoTypeAssociations; QPointer m_customData; QList m_history; // Items sorted from oldest to newest QScopedPointer m_tmpHistoryItem; bool m_modifiedSinceBegin; QPointer m_group; bool m_updateTimeinfo; }; Q_DECLARE_OPERATORS_FOR_FLAGS(Entry::CloneFlags) #endif // KEEPASSX_ENTRY_H