Click here to Skip to main content
Click here to Skip to main content
Articles » Languages » C# » General » Downloads
 
Add your own
alternative version

Password Safe Database Reader Library in C# for .NET

, 16 Oct 2007
An independent library implementation to read Password Safe Password Manager V3 database files
#region License
/*
 *  PasswordSafe Database Reader/Writer
 *
 *  Copyright (C) 2007 Svante Seleborg
 *
 *  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 3 of the License, or
 *  (at your option) any later version.
 *
 *  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 <http://www.gnu.org/licenses/>.
 * 
 *  If you'd like to license this program under any other terms than the
 *  above, please contact the author and copyright holder.
 *
 *  Contact: mailto:svante@axantum.com
 */
#endregion

using System;
using System.Collections.Generic;
using System.Globalization;

namespace Axantum.PasswordSafe
{
    public class PasswordSafePasswordHistory
    {
        /// <summary>
        /// Initializes a new instance of the <see cref="PasswordSafePasswordHistory"/> class.
        /// </summary>
        public PasswordSafePasswordHistory()
        {
            Status = 0;
            MaxHistory = 0;
        }

        private byte _status;

        /// <summary>
        /// Gets or sets the status.
        /// </summary>
        /// <value>The status.</value>
        public byte Status
        {
            get { return _status; }
            set { _status = value; }
        }

        private byte _maxHistory;

        /// <summary>
        /// Gets or sets the max number of entries in the history.
        /// </summary>
        /// <value>The max number of history entries</value>
        public byte MaxHistory
        {
            get { return _maxHistory; }
            set { _maxHistory = value; }
        }

        private List<PasswordSafePassword> _passwordHistory = new List<PasswordSafePassword>();

        /// <summary>
        /// Gets the password history.
        /// </summary>
        /// <value>The password history.</value>
        public ICollection<PasswordSafePassword> PasswordHistory
        {
            get
            {
                return _passwordHistory;
            }
        }

        /// <summary>
        /// Adds a password to the password history list.
        /// </summary>
        /// <param name="password">The password.</param>
        public void PasswordHistoryAdd(PasswordSafePassword password)
        {
            _passwordHistory.Add(password);
        }

        /// <summary>
        /// Parses a password history from the database serialized format which is:
        /// smmnnddddddddllll[passsword] ...
        /// 's' is a decimal status.
        /// 'mm' is a hex max number of password history entries
        /// 'nn' is a hex number of passwords in this list
        /// The following is repeated 'nn' times:
        /// 'dddddddd' is a hex representation of 32-bit unix time when this password was changed.
        /// 'llll' is a hex representation of 16-bit length of the password that follows.
        /// [password] is the string of the password.
        /// </summary>
        /// <param name="serialized">The serialized string</param>
        /// <returns>The decoded password history</returns>
        static public PasswordSafePasswordHistory Parse(string serialized)
        {
            if (serialized == null)
            {
                throw new ArgumentNullException("serialized");
            }

            PasswordSafePasswordHistory history = new PasswordSafePasswordHistory();
            if (serialized.Length < 5)
            {
                return history;
            }

            history.Status = Byte.Parse(serialized.Substring(0, 1), NumberStyles.Integer, CultureInfo.InvariantCulture);
            history.MaxHistory = Byte.Parse(serialized.Substring(1, 2), NumberStyles.HexNumber, CultureInfo.InvariantCulture);
            int numberOfPasswords = Int32.Parse(serialized.Substring(3, 2), NumberStyles.HexNumber, CultureInfo.InvariantCulture);
            int currentIndex = 5;

            for (int i = 0; i < numberOfPasswords; ++i)
            {
                int unixTimeChanged = Int32.Parse(serialized.Substring(currentIndex, 8), NumberStyles.HexNumber, CultureInfo.InvariantCulture);
                DateTime passwordChangedUtc = PasswordSafeUtility.GetUtcFromUnixTime(unixTimeChanged);
                currentIndex += 8;

                int passwordLength = Int32.Parse(serialized.Substring(currentIndex, 4), NumberStyles.HexNumber, CultureInfo.InvariantCulture);
                currentIndex += 4;

                string password = serialized.Substring(currentIndex, passwordLength);
                currentIndex += passwordLength;

                history.PasswordHistoryAdd(new PasswordSafePassword(password, passwordChangedUtc));
            }

            return history;
        }
    }
}

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article, along with any associated source code and files, is licensed under The GNU General Public License (GPLv3)

About the Author

Svante Seleborg
Web Developer Axantum Software AB
Sweden Sweden
I've been working with all aspects of software development since 1979 - from compiler construction to management. Currently I'm an independent consultant mostly specializing in computer security. Please see my homepage for contact details.
 
I speak C like a native, and have a pretty good grasp of C++. The most recent five years C# has been the main development language. Traditionally Unix has been the dominating environment, but currently the scales have tipped over to Windows, due to market demands but I'm equally at home developing in both environments.
 
When I'm not coding I'm usually sitting on one of my 4 bikes, indoors or outdoors, on the road or in the woods.

| Advertise | Privacy | Mobile
Web01 | 2.8.140721.1 | Last Updated 16 Oct 2007
Article Copyright 2007 by Svante Seleborg
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid