File: README.md

package info (click to toggle)
pass-report 0.4-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 112 kB
  • sloc: sh: 127; makefile: 13
file content (75 lines) | stat: -rw-r--r-- 1,957 bytes parent folder | download
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
# pass-report

A [pass](https://www.passwordstore.org) extension that reports age and length of
passwords.

![screenshot](screenshot.png)

## Description

`pass report` shows the date and age of the last change of a set of passwords.
It can also shows an indication of their length, inspired by an [ANSSI
article](https://www.ssi.gouv.fr/administration/precautions-elementaires/calculer-la-force-dun-mot-de-passe/)
(_french_).

This tool uses `git blame` and `git show` to find the last commit editing the
first line of a password, thus ignoring renames and reencrypts.

**Note:** this extension may take a long time to show data for all passwords as
it needs to decrypt each of them.

This extension and the configuration were inspired by [this
thread](https://lists.zx2c4.com/pipermail/password-store/2015-July/001638.html).

## Usage

```
Usage:
      pass report [-c|--color] [-l|--length] [<password file>]
            Report last change's date and age of all passwords or given
            password

         Options:
            -c, --color    Show old password (more than 2 years) in yellow
            -l, --length   Show password length indication
            -h, --help     Show this help

         Password length indication:
            very short     Less than 8 characters
            short          Less than 13 characters
            medium         Less than 17 characters
            long           17 characters or more
```

## Installation

### Requirements

* `pass 1.7.0` or greater
* Your store must use git

#### Git and GPG

You must configure git in order to handle `.gpg` files with `git blame` and `git
show`:

``` gitconfig
[diff "gpg"]
   textconv = gpg --no-tty --decrypt --quiet
[blame "gpg"]
   textconv = gpg --no-tty --decrypt --quiet
```

### Installation from source

``` bash
git clone https://github.com/Kdecherf/pass-report
cd pass-report
sudo make install
```

### Exherbo

``` bash
cave resolve pass-report -x1
```