📦

connector-googlemail

Name: connector-googlemail
Author: caffeinelabs

v0.2.3 مراجعة المحتوى r1 مخاطر عالية ⚙️ الأوامر الخارجية🌐 الوصول إلى الشبكة📁 الوصول إلى نظام الملفات

Build Gmail Connections for Caffeine Apps

Gmail integrations require careful OAuth, token storage, and callback handling. This skill provides a complete Motoko and frontend recipe for connecting accounts and sending email.

يدعم: Claude Codex Code(CC)

⚠️ 38 ضعيف

توقف واطلب التأكيد قبل التثبيت.

راجع الخطة واحصل على موافقة صريحة من المستخدم قبل تغيير الملفات.

التثبيت باستخدام Agent لدي

انسخ هذا الطلب إلى Agent لديك. يتضمن صفحة Skill المعتمدة وملف manifest.

طلب الوكيل

Review the Skillstore skill "connector-googlemail" from https://skillstore.io/skills/caffeinelabs-connector-googlemail.md and its manifest at https://skillstore.io/api/skills/caffeinelabs-connector-googlemail/manifest. Verify the artifact. Stop and obtain explicit user consent before installing or changing files.

يجب أن يواصل Agent عرض خطته وطلب أي تأكيد تفرضه سياسة الأمان.

موارد مهيّأة لـ Agents

استخدم هذه الروابط عندما يحتاج AI Agent أو crawler أو script إلى سياق نظيف بدلًا من قراءة الصفحة كاملة.

تفاصيل Markdown GET /skills/caffeinelabs-connector-googlemail.md manifest موقَّع GET /api/skills/caffeinelabs-connector-googlemail/manifest lockfile موقَّع GET /api/skills/caffeinelabs-connector-googlemail/lockfile

اختبرها

جارٍ استخدام "connector-googlemail". Build a send-only Gmail connector for signed-in users.

النتيجة المتوقعة:

Dependencies use the documented Gmail, OAuth, and authorization package versions.
Each user completes a PKCE flow and receives caller-keyed backend token storage.
The send operation uses the Gmail send scope and one refresh attempt after HTTP 401.
The frontend includes reachable settings and callback routes.

جارٍ استخدام "connector-googlemail". Combine Gmail sending with Google Calendar access.

النتيجة المتوقعة:

One admin credential set serves both Google services.
One callback exchanges the authorization code for a shared per-user connection.
The consent request contains the union of required Gmail and Calendar scopes.
Each API creates its own non-replicated client configuration from the shared token.

التدقيق الأمني

مخاطر عالية

v1 • ٢٣‏/٧‏/٢٠٢٦ فتح التقرير المرتبط بالإصدار

All 255 static findings are false positives caused by Markdown backticks, documented Google and Mops URLs, fixed relative links/imports, ellipses, and Gmail or OIDC terminology. Semantic review found unvalidated RFC 5322 headers and a disconnect flow that deletes local state without revoking Google's refresh token.

الملفات التي تم فحصها

764

الأسطر التي تم تحليلها

عناصر المراجعة

تم تجاهل الإيجابيات الكاذبة

مخاوف أمنية مؤكدة (2)

مرتفع

SKILL.md:390-392

RFC 5322 Header Injection

The sample concatenates `to` and `subject` directly into RFC 5322 headers. Newlines can inject headers, add recipients, or alter message structure.

Lines 390-392 show direct concatenation with no CR or LF validation before the message is sent.

متوسط

SKILL.md:303-307

Disconnect Does Not Revoke Google Token

The disconnect endpoint removes the map entry without revoking the Google refresh token. A previously exposed token remains usable after users disconnect.

Lines 303-307 only remove local state and contain no Google token revocation call.

عوامل الخطر

⚙️ الأوامر الخارجية (50)

🌐 الوصول إلى الشبكة (20)

📁 الوصول إلى نظام الملفات (8)

SKILL.md:46 SKILL.md:234 SKILL.md:337 SKILL.md:562 SKILL.md:599 SKILL.md:734 SKILL.md:742 SKILL.md:763

دقّقه: codex

شارك واستشهد بهذا التقرير

شارك تقرير التقييم المرتبط بالإصدار والشارة المحايدة وبطاقة التضمين والاستشهادات. تعرض Skillstore الأدلة من دون أن تقرر ما إذا كانت هذه المهارة آمنة.

فتح التقرير المرتبط بالإصدار

نسخ رابط التقرير

https://skillstore.io/skills/caffeinelabs-connector-googlemail/audits/1?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

شارة Markdown

[![Skillstore security assessment](https://skillstore.io/badges/skills/caffeinelabs-connector-googlemail/security.svg)](https://skillstore.io/skills/caffeinelabs-connector-googlemail?utm_source=security_passport_badge)

شارة HTML

<a href="https://skillstore.io/skills/caffeinelabs-connector-googlemail?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/caffeinelabs-connector-googlemail/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

بطاقة قابلة للتضمين

<iframe src="https://skillstore.io/embed/skills/caffeinelabs-connector-googlemail.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>

الاستشهادات الأكاديمية (APA · BibTeX · CFF)

اقتباس APA

caffeinelabs. (2026). connector-googlemail security audit report (audit version 1) [Author version 0.2.3]. Skillstore. https://skillstore.io/skills/caffeinelabs-connector-googlemail/audits/1

اقتباس BibTeX

@techreport{caffeinelabs-caffeinelabs-connector-googlemail-2026,
  author = {caffeinelabs},
  title = {connector-googlemail security audit report (audit version 1)},
  institution = {Skillstore},
  year = {2026},
  number = {1},
  url = {https://skillstore.io/skills/caffeinelabs-connector-googlemail/audits/1},
  note = {Author version 0.2.3}
}

CITATION.cff

cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "connector-googlemail security audit report (audit version 1)"
version: "0.2.3"
type: report
authors:
  - name: "caffeinelabs"
date-released: "2026-07-23"
url: "https://skillstore.io/skills/caffeinelabs-connector-googlemail/audits/1"
identifiers:
  - type: other
    value: "skillstore:caffeinelabs-connector-googlemail:audit:1"
    description: "Skillstore immutable audit report identifier"

تقييم Skillstore

سبب هذا التقييم موثوقية الأدلة: متوسط

الهندسة المعمارية

100

قابلية الصيانة

المحتوى

المجتمع

الامتثال للمواصفات

ما الذي يمكنك بناؤه

Add Gmail Sending

Implement authenticated email sending from each user's Gmail account with minimal scopes and automatic token refresh.

Build OAuth Screens

Create reachable credential settings and callback routes that preserve OAuth state and wait for actor readiness.

Combine Google Services

Share one OAuth connection, credential set, and union scope across Gmail and Google Calendar features.

جرّب هذه الموجّهات

Create Send-Only Gmail

Build a send-only Gmail connector for my Caffeine app. Use the documented Mops versions, per-user PKCE, and the smallest required scopes.

Add OAuth Frontend

Add admin Gmail settings and a real /connect/gmail callback route. Show the exact redirect URI and wait for authenticated actor readiness.

Extend Mailbox Access

Extend the connector to list Gmail messages. Request gmail.readonly only for reading, preserve non-replicated calls, and retry once after a 401.

Unify Gmail and Calendar

Create one shared Google OAuth flow for Gmail and Calendar. Use union scopes, one connection map, and separate non-replicated client configurations.

أفضل الممارسات

Request only the Gmail scopes required by implemented operations.
Keep client secrets and bearer tokens in the canister behind caller and admin checks.
Use one exact callback URI, generate state on the backend, and validate it before token exchange.

تجنب

Do not hand-roll Google HTTP requests when the documented OAuth and Gmail packages provide the operation.
Do not return client secrets, access tokens, refresh tokens, or complete connection records to the frontend.
Do not create separate OAuth flows for Gmail and Calendar when both use the same Google account.

الأسئلة المتكررة

Which applications does this skill support?

It supports Caffeine AI applications written in Motoko for the Internet Computer.

Whose address sends the email?

Messages are sent from the signed-in user's connected Gmail account, not a shared application mailbox.

Which scopes are required for sending?

Use openid, email, and gmail.send. Add gmail.readonly only when the application reads mailbox data.

Can the frontend access OAuth tokens?

No. The recipe keeps tokens in caller-keyed canister state and returns only status, email address, and authorization URLs.

Does disconnect revoke Google access?

No. The sample removes local connection state only. Production applications should revoke the Google refresh token before deletion.

How should Gmail and Calendar share OAuth?

Use one credential set, one callback route, union scopes, and one per-user connection shared by both service clients.

تفاصيل المطور

المؤلف

caffeinelabs

الترخيص

MIT

إصدار المؤلف

v0.2.3

مراجعة Skillstore

المستودع

https://github.com/caffeinelabs/skills/tree/10fb452613c797633b8cb33639fc9a754a138039/skills/connector-googlemail

مرجع

f32f934280aa94e399d875d7cf7b2ed16d1b82a3

حداثة الصيانة

٢٣‏/٧‏/٢٠٢٦

الاستخدام

0 تنزيلات · 0 مشاهدات

بنية الملفات

📄 SKILL.md