Bookmarking/Searching inside Folders using Query String Parameters

To search inside a specific folder, you have a few options:

Querystring Parameters


folder
- you can specify an absolute folder path or any folder to find by name.


Example:
To search for secrets named "test" in the folder "RootFolder\TestSecrets" on the server "https://www.secretserveronline.com", you can enter "https://www.secretserveronline.com/home.aspx?term=test&folder=RootFolder\TestSecrets" as the URL.
 
To search for folders that contain spaces in their names, use the '+' symbol to denote a space.  For example, searching in "RootFolder\Folder With Spaces" would be accomplished with the URL "www.secretserveronline.com/home.aspx?term=test&folder=RootFolder\Folder+With+Spaces" .

If you specify a folder name without an absolute path, then Secret Server will locate that folder and search inside of it.  For example, if a folder named "ChildFolder" exists under "RootFolder\TestSecrets", then you can locate a secret named "Child" inside of "ChildFolder" using "www.secretserveronline.com/home.aspx?term=Child&folder=ChildFolder" as the URL.  If multiple folders have the same name, then the first folder found matching that name is returned.




searchsubfolders
- you can specify whether subfolders should be searched. The value of this parameter can either be true or false.  If this value is not provided, then it will default to last value set by the user when they were on the Home screen.


Example:
"https://www.secretserveronline.com/home.aspx?term=test&folder=RootFolder&searchsubfolders=true" would search for all secrets named "test" inside of "RootFolder" and all of its child folders.

This feature can be used to build links into Secret Server from CRM applications such as ConnectWise CRM or Microsoft CRM.

Note that this feature is only available in Secret Server 6.2 and above.

Article ID: 44, Created On: 7/6/2009, Modified: 12/16/2011