Link Search Menu Expand Document

Recycling the credentials is an important process in web development. It should be done at regular intervals or due to the following reasons.

When should we recycle credentials

The credentials were exposed

  • The credentials should be recycled when they are exposed.
  • The exposing credentials can be done by mistakenly by commiting the particular credentials in the commit(github) or some other version control.


  • If the developer working in any public repository or any other Open Source project, If he unknowingly exposed the credentials in any of his commit, the code which he committed can be viewed by anyone, and he/she can misuse the credentials from which we exposed.

  • At this case the credentials should be recycled.

The credentials are lost

  • The Credentials should be recycled when the developer to loses the credentials


  • When the developer uses rails encrypted credentials feature, It needs master key to encrypt the credentials.
  • When we loose the master key there is no way to recover our credentials back, if we don’t know what are the credentials we used to encrypt.

Unauthorized Usage

  • The Credentials should be recycled when we suspect any unauthorized person uses our credentials.


  • If the monthly bill of our postmark is increased suddenly, we should run a diagnosis if some unwanted emails were gone, if it is confirmed then our credentials got exposed in any form.
  • At this stage process of recycling the credentials is the safe way. After following the above mentioned step, the better way to check how the keys got exposed, if it is not found then recycling of credentials won’t help.

Developer Quits

  • The Process of recycling the credentials is important when the developer quits the job, the one who works in that project, he may know the credentials which he worked.
  • He might can misuse the credentials or accidentally he may use our project credentials in some other Open Source project.
  • In this case its safe to recycle the credentials at the time when the developer quits.

Recycle credentials in interval basis

  • To reduce chaos the Recycling Credentials should be done in a regular intervals.
  • In this case we can make sure our credentials or not compromised.

What is the process

Notify other users

  • There are mainly three cases to be noticed at the time we regenerate the credentials

    1. In first case we can generate new credentials, eventhough the old key will still be active.
      • In this case we need to send an email to all the team members and the client to inform that the key has been changed in this {product} in {project}. Then set a deadline to use the old key then ask the other team members and client to confirm is it ok to delete the old key within a week and at particular time. eg. 31/12/2019 at 10.00
      • If everyone accepts then the old key can be deleted in the date which you set.
    2. In second case we can only use one credentials at a time, In this case if we generate new secret id or secret key we need to inform the other users who were using the old one because the old one became invalid if we generate the new credentials.
      • In this case we need to send an email to all the team members and the client to inform that the new key is going to be generated in this {product} which we using in this {project}. Then set a deadline to generate a new key then ask the other team members and client to confirm to generate new key within a week and at particular time. eg. 31/12/2019 at 10.00
      • If everyone accepts then generate the new key and share with the team members and client.
      • Then the old credentials should be replaced by the new one all over projects where we used.
    3. In the third case if our key is exposed and if some hacker is using our key, in this type of case send an email to other team members and client to inform that we are going to generate a new key.

    4. At last we can generate a new key and replace them only at the time of emergency


    • If the hacker got our aws access key and he creats multiple server in it, no problem you can still wait for other team members approval by sending an email.
    • But in this case when hacker messing with our platform, and our platform goes down then only its time to change the key without any prior notification.


  • RazorPay has only one valid id and key at a time.
  • Secret keys are visible only at the time of key generation. If you have already generated your keys and do not remember your secret key, you will need to re-generate the keys from the Dashboard and replace it in your integration code.

Generate new key

  • To recycle the credentials just generate a new key and replace everywhere in the project instead of the old one.

Test the newly generated key

  • After replacing the new credentials over the old one just test in the code whether the newly generated key works.

Remove the old key

  • The major procedure to follow in the process of recycling the credentials is to removing the old key from the projects and from the third party apps.
  • Deleting the old key from the third party apps is the important one after generating the new one because the old keys still have access to the app.


  • Postmarkapp will allow multiple keys to be in active, if someone exposes some old key in any other open source, the intruder can use the postmarkapp by our old key, It is safe to remove old keys from the apps and from the code base.

Test after deleting the old keys

  • In some other cases when we are testing the code base before deleting the old credentials after generating the new credentials, the function may work due to the old credentials, that’s why its safe to test after deleting the old credentials too.


  • Its a good process to log the time and date of when we recycled the credentials in which project.
  • For this process we can use Atlassian confluence
  • Click on the + icon on the left side dashboard.
  • Then select the project name fro the dropdown called select space.
  • After that select blank page options from the menu and click create button.
  • Then name the page as Log for recycling credentials. create a table with two column and name them as Product name and Last changed date.
  • Then log the product name and the date when the key is changed.
  • Then go to the right side top corner of the page there you’ll find publish option click that option to display your changes in public.
  • so now we know when to recycle the credentials next time.