Credentials

Direct Username/Password Credentials

CredentialServiceType.None is the baseline credential source: WithUsername and WithPassword set the values directly, and SaveTo(grid) appends a single [Username, Password] row built from those values - no vault is queried, and GetCredentialsFor/WithDomain have no effect. This is the same shape used internally by WithCredentials to build a master login for the password-manager services.

NOTE

WithWebAuth(WebAuthType) records how a site expects to be given a credential, so GPAL knows what to do with it instead of leaving the workflow to work it out. Basic, Proxy and Bearer are settled before the first request and need nobody. Digest is a challenge and response, so it cannot be sent ahead of the challenge and the browser answers it itself. XAuthToken, XApiKey and ApiKey present a token the workflow already holds. Form is a page like any other: GPAL holds the credential so it lives in one place, and the workflow drives the fields with selectors, because there is no other way in.

Examples

GPAL Fluent: High-level fluent C# API

//SaveTo(grid) appends a [Username, Password] row regardless of ServiceType, so the same FillInFrom step works whether the credentials came directly from code, a password manager vault, or were built as a master login for WithCredentials.

// Direct username/password - no password manager involved

var grid = GPAL.Grid.ToGPALObject();

ICredentials login = GPAL.CredentialsFor(CredentialServiceType.None)

.WithUsername("admin@example.com")

.WithPassword("s3cret")

.ToGPALObject();

// Use the grid to fill in a login form

GPAL.Browser

.GoTo("https://example.com/login")

.WithSelector("#username")

.WithSelector("#password")

.FillInFrom(grid)

.WithSelector("#login")

.LeftClick();

Documentation Example

Documentation

Showing off some plain text in these paragraphs eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Other formats

Here you can find different accents and emphasis sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

This is a link and how it could look like bestlinkinthebeautifulworld. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Here's just some classic bold text adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam notBoldSecondbestlinkinthebeautifulworld illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at adipisicing elit libero vel voluptas? Expedita, adipisicing facere dolores voluptatem ad ab rem assumenda soluta!

Other cuple of colors in case we want to emphasize several ways adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam adipisicing elit illo nostrum corporis at voluptatem libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta!

Adding Images to the content

Lorem ipsum dolor sit amet consectetur adipisicing elit. Obcaecati, iste distinctio veritatis eligendi laboriosam illo nostrum corporis at libero vel voluptas? Expedita, facere dolores voluptatem ad ab rem assumenda soluta! Lorem ipsum dolor, sit amet consectetur adipisicing elit. Quod veniam, quam ad expedita laborum sed at voluptates culpa ipsam ut vel. Ullam temporibus a mollitia quod aliquam ratione exercitationem nesciunt.

Coding Blocks

Lorem ipsum dolor sit amet consectetur adipisicing elit. Repudiandae quas consequuntur illo numquam assumenda autem exercitationem distinctio perspiciatis in natus. Eius dicta similique ipsam ipsa minima, nemo quae enim tempore.

GPAL

.CallIfNotFound(GenericCallIfNotFound)

.WithPublishToConsole();

//System.Drawing.Rectangle windowSize = new System.Drawing.Rectangle(10, 10, 1500, 1024);

// NOTE: we have to set browser = before we execute any steps

// this is due to the 'GenericCallIfNotFound' which might throw an exception, and BankScraper will not have the browser set when it calls scraper.Close()

// until the complete fluent line gets executed (meaning every step, meaning browser is not set until everything else succeeds)

browser = GPAL.Browser

.WithBrowserType(Enums.BrowserType.Chrome)

.WithProfileDataDirectory(ChromeProfileLocation)

.WithUseAutomationEngine(AutomationEngine.Selenium)

.WithWindowSize(new System.Drawing.Rectangle(0,0,1920,1080))

.ToGPALObject();

Credentials

Credentials

Direct Username/Password Credentials

Examples

Documentation Example

Documentation

Category

Endpoint

Enpoint

Enpoint

Enpoint

Other formats

Adding Images to the content

Coding Blocks

On this page