# Setting cookies

#### Introduction <a href="#id-0-toc-title" id="id-0-toc-title"></a>

You can set cookies to customize browser sessions for various use cases, including authenticated sessions, tracking, and testing. This feature helps you simulate different user sessions by configuring cookies programmatically.

#### Configuring Cookies <a href="#id-1-toc-title" id="id-1-toc-title"></a>

Cookies can be set on a page after the browser instance is launched and before navigating to the target URL. Below are the steps to configure cookies.

**1. Set Cookies for the Browser Session**

Here is a C# example showing how to set cookies in a browser managed by **CloudBrowser**.

```csharp
using System;
using System.Net.Http;
using System.Threading.Tasks;
using PuppeteerSharp;

public class Program
{
    public static async Task Main(string[] args)
    {
        var serverUrl = "https://production.cloudbrowser.ai/api/v1/Browser/Open";
        var apiToken = "your-api-token"; // Replace with your actual API token

        // Define the cookies
        var cookies = new CookieParam[]
        {
            new CookieParam { Name = "example_cookie", Value = "cookie_value", Domain = "example.com" },
            new CookieParam { Name = "session_id", Value = "123456", Domain = "example.com" }
        };

        // Create an HttpClient and include the API token in the request headers
        var httpClient = new HttpClient();
        httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", apiToken);

        // Request the WebSocket endpoint of the remote browser
        var browserWSEndpoint = await httpClient.GetStringAsync(serverUrl);

        // Connect to the remote browser
        var browser = await Puppeteer.ConnectAsync(new ConnectOptions
        {
            BrowserWSEndpoint = browserWSEndpoint
        });

        // Create a new page
        var page = await browser.NewPageAsync();

        // Set cookies
        await page.SetCookieAsync(cookies);

        // Navigate to a URL to verify the cookies
        await page.GoToAsync("https://www.cloudbrowser.ai");

        // Close the browser
        await browser.CloseAsync();
    }
}
```

**2. Code Explanation**

1. **Define the Cookies**: Create an array of `CookieParam` objects with the cookie details you want to set.

```
   var cookies = new CookieParam[]
   {
       new CookieParam { Name = "example_cookie", Value = "cookie_value", Domain = "example.com" },
       new CookieParam { Name = "session_id", Value = "123456", Domain = "example.com" }
   };
```

2. **Request the WebSocket Endpoint**: Use `HttpClient` to send a GET request to the server URL to obtain the WebSocket endpoint.

```
   var httpClient = new HttpClient();
   var browserWSEndpoint = await httpClient.GetStringAsync(serverUrl);
```

3. **Connect to the Remote Browser**: Use `Puppeteer.ConnectAsync` to connect to the browser using the obtained WebSocket endpoint.

```
   var browser = await Puppeteer.ConnectAsync(new ConnectOptions
   {
       BrowserWSEndpoint = browserWSEndpoint
   });
```

4. **Create a New Page**: Create a new page instance in the browser.

```
   var page = await browser.NewPageAsync();
```

5. **Set Cookies**: Use `page.SetCookieAsync` to set the defined cookies on the page.

```
   await page.SetCookieAsync(cookies);
```

6. **Navigate and Verify**: Navigate to the target site to verify that the cookies are set.

```
   await page.GoToAsync("https://example.com");
```

7. **Close the Browser**: Close the browser when finished.

```
   await browser.CloseAsync();
```

#### Additional Considerations <a href="#id-4-toc-title" id="id-4-toc-title"></a>

* **Cookie Attributes**: Ensure that the cookie attributes like `Domain`, `Path`, and `Expires` are set correctly according to your requirements.
* **Secure and HttpOnly Flags**: Be aware of `Secure` and `HttpOnly` flags on cookies which affect their scope and security.
* **Error Handling**: Implement error handling to capture and manage potential issues when setting cookies or connecting to the browser.

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cloudbrowser.gitbook.io/docs/configurations/setting-cookies.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.