≡ Menu

OpenSSH: ssh-add / ssh-agent Command Set Maximum Lifetime In Seconds

I‘m using a Mac OS X and combination of ssh-agent+ssh-add to adds RSA or DSA identities to the authentication agent. ssh-agent provides me a secure way of storing the private key. However, I’d like to expire identities added to the agent within half an hour. How do I set lifetime of identities added to the agent under Unix / Linux / BSD / Apple OS X operating systems?

Both the ssh-agent and ssh-add command has an option to set a default value for the maximum lifetime of identities added to the agent. The lifetime may be specified in seconds or in a time format specified in /etc/ssh/sshd_config file. A lifetime specified for an identity with ssh-add overrides this value. Without this option the default maximum lifetime is forever. The syntax is as follows to expire identities added to the agent within half an hour:

ssh-agent -t 30 bash


ssh-agent ksh
ssh-add -t 30

Time Format Examples

sshd server command-line arguments and configuration file options that specify time may be expressed using a sequence of the form:


where, time is a positive integer value and qualifier is one of the following:

none (default)secondsssh-agent -t 30
ssh-add -t 30
s or Ssecondsssh-agent -t 30s
ssh-add -t 30S
m or Mminutesssh-agent -t 30m
ssh-add -t 30M
h or Hhoursssh-agent -t 30h
ssh-add -t 30H
d or Ddaysssh-agent -t 1d
ssh-add -t 1D
w or W weeksssh-agent -t 2w
ssh-add -t 2W

You can combine each member of the sequence from the above table and it is added together to calculate the total time value. In this example, expire identities added to the agent within 90 minutes:
$ ssh-agent bash
$ ssh-add -t 90m
$ ssh vivek@server1.cyberciti.biz

$ ssh-agent bash
$ ssh-add -t 1h30m
$ ssh vivek@server1.cyberciti.biz

The maximum lifetime is set to 90 minutes i.e. after 90 minutes you will not able to login to the server. So if someone stole your laptop or tried to access unprotected console session they will not able to use your private keys.

Say Hello To keychain

I strongly recommend that you use keychain as a manager for ssh-agent, typically run from ~/.bash_profile as follows:
$ /usr/bin/keychain --clear $HOME/.ssh/id_rsa
The above will delete all of ssh-agent’s keys. Typically this is used in .bash_profile. The theory behind this is that keychain should assume that you are an intruder until proven otherwise. However, while this option increases security, it still allows your cron jobs to use your ssh keys when you’re logged out.

Share this tutorial on:

Your support makes a big difference:
I have a small favor to ask. More people are reading the nixCraft. Many of you block advertising which is your right, and advertising revenues are not sufficient to cover my operating costs. So you can see why I need to ask for your help. The nixCraft, takes a lot of my time and hard work to produce. If you use nixCraft, who likes it, helps me with donations:
Become a Supporter →    Make a contribution via Paypal/Bitcoin →   

Don't Miss Any Linux and Unix Tips

Get nixCraft in your inbox. It's free:

{ 1 comment… add one }
  • Santiago Castro August 15, 2015, 6:52 pm

    The default time set here sets 30 seconds not 30 minutes

Security: Are you a robot or human?

Leave a Comment

You can use these HTML tags and attributes: <strong> <em> <pre> <code> <a href="" title="">

   Tagged with: , , , , , , , , , , , , , , , , , , , , , ,