การมองเห็นแอป
เลือกว่าใครเปิดแอปที่ deploy แล้วของคุณได้: ทุกคนบนอินเทอร์เน็ต ทั้งองค์กรของคุณ หรือเฉพาะคนที่คุณเชิญ
ภาพรวม
แอป Stardeck ทุกแอปมีการตั้งค่า visibility ที่กำหนดว่าใครเข้าถึงแอปได้เมื่อ deploy แล้ว หากแอปมี Surface ด้วย visibility ของแอปยังมีผลเหนือกว่า: Surface แบบ public ในแอปแบบ internal หรือ private จะยังเป็น internal Surface ตั้งค่าได้แค่ public หรือ internal เท่านั้น ไม่มีการตั้งค่าแบบ private แยกรายต่อ Surface
| Visibility | ใครเข้าถึงได้ | เปิดให้บริการที่ไหน |
|---|---|---|
| Public | ทุกคนบนอินเทอร์เน็ต | URL สาธารณะของแอป (เช่น your-app.stardeck.site) |
| Internal | ทุกคนในองค์กรของคุณ | ภายใน Stardeck ที่ URL ภายใน |
| Private | คุณ ผู้ร่วมงานที่ได้รับเชิญ และสมาชิกในทีมที่ได้รับมอบหมายให้แอปนี้ | ภายใน Stardeck ที่ URL ภายใน |
เลือกแบบที่ตรงกับสิ่งที่คุณกำลังสร้าง:
- Public — เว็บไซต์ที่ลูกค้าใช้ หน้าการตลาด ผลิตภัณฑ์ SaaS หน้าร้านออนไลน์
- Internal — เครื่องมือสำหรับทั้งทีม: คอนโซลผู้ดูแล dashboard KPI wiki ภายใน พอร์ทัลพนักงาน
- Private — เครื่องมือสำหรับกลุ่มเฉพาะ: POS ของร้านเดียว dashboard สำหรับพาร์ตเนอร์ หรือพื้นที่ทดลองส่วนตัวที่คุณยังไม่ได้แชร์
แอปใหม่เริ่มต้นเป็น public
แอปใหม่ทุกแอปถูกสร้างเป็น Public ไม่ว่าคุณจะสร้างใน dashboard หรือ coding agent ของคุณสร้างด้วย create_app หากต้องการให้เป็น internal หรือ private ให้เปลี่ยนในการตั้งค่าหลังจากสร้างแอปแล้ว
แอป internal และ private ต้องใช้แพ็กเกจที่รองรับ ทุกแพ็กเกจในปัจจุบันรองรับ แต่แพ็กเกจรุ่นเก่าบางแพ็กเกจไม่รองรับ และการตั้งค่านี้จะแสดงข้อความให้อัปเกรด
เปลี่ยน visibility ภายหลัง
เปิดแอปของคุณ ไปที่ Settings → General แล้วเลือก visibility ใหม่ คุณจะเห็นกล่องยืนยันที่บอกชัดเจนว่าอะไรจะเปลี่ยนบ้าง
coding agent ของคุณก็เปลี่ยนได้ด้วยเครื่องมือ update_app_settings การเปลี่ยน visibility จะขอให้คุณยืนยันก่อน
การเปลี่ยน visibility ทำให้ URL ของแอปเปลี่ยน แอป public อยู่บนโดเมนแอปสาธารณะ (เช่น
your-app.stardeck.site) ส่วนแอป internal และ private อยู่บน subdomain ภายในอีกชุดหนึ่ง
บุ๊กมาร์กหรือลิงก์เดิมที่ชี้ไปยัง URL เก่าจะใช้ไม่ได้หลังจากสลับ
ถ้าคุณสลับแอป public เป็น internal หรือ private:
- URL สาธารณะจะไม่แสดงแอปของคุณอีก
- ผู้ใช้แอปที่สมัครผ่านหน้าเข้าสู่ระบบของแอปที่ deploy ไว้จะเข้าถึงไม่ได้ เพราะเข้าสู่ระบบ Stardeck ไม่ได้ จึงเปิดแอป internal หรือ private ไม่ได้
- แอปของคุณจะได้ URL ใหม่บนโดเมนแอปภายใน
ถ้าคุณสลับแอป internal หรือ private เป็น public:
- ทุกคนบนอินเทอร์เน็ตเข้าถึงแอปของคุณได้
- การตั้งค่าการสมัครใช้งานของผู้ใช้ปลายทางจะกลับมาทำงาน ตรวจสอบการตั้งค่า Authentication ให้แน่ใจว่าตั้งพฤติกรรมการสมัครไว้ถูกต้อง
- แอปย้ายไปอยู่บนโดเมนแอปสาธารณะและได้ URL ใหม่
ถ้าคุณสลับระหว่าง internal กับ private:
- URL ไม่เปลี่ยน (ทั้งสองแบบอยู่บนโดเมนแอปภายในเหมือนกัน)
- กฎการเข้าถึงเปลี่ยน: internal เปิดให้ทั้งองค์กร ส่วน private จำกัดเฉพาะผู้ร่วมงานที่ได้รับเชิญและสมาชิกในทีมที่ได้รับมอบหมาย
ใครเข้าถึงแอปได้บ้าง
สมาชิกในทีม ผู้ร่วมงาน และผู้ใช้แอป เข้าถึงแอปต่างกัน เรื่องบทบาทและสิทธิ์เฉพาะแอปอยู่ใน สมาชิกและบทบาท การแก้ไขแอปแยกจากการเข้าถึงแอป และต้องมีสิทธิ์ Edit Apps (apps:write) ในบทบาทระดับองค์กรของบุคคลนั้น หรือใน Team role สำหรับแอปนั้น
| Visibility | สมาชิกในทีม | ผู้ร่วมงาน (แท็บ Members ของแอป) | ผู้ใช้แอป |
|---|---|---|---|
| Public | เข้าถึงได้ | เข้าถึงได้ | เข้าถึงได้ (ถ้าเปิดให้สมัคร) |
| Internal | เข้าถึงได้ | เข้าถึงได้ | ❌ เข้าถึงไม่ได้ |
| Private | เฉพาะผู้สร้างและผู้ที่ได้รับมอบหมายให้แอปนี้ | เข้าถึงได้ | ❌ เข้าถึงไม่ได้ |
ความแตกต่างสำคัญระหว่าง internal กับ private คือการเป็นสมาชิกในทีมเพียงอย่างเดียวให้สิทธิ์เข้าถึงหรือไม่ แอป internal มีไว้สำหรับทั้งทีม ส่วนแอป private ต้องมีคำเชิญหรือการมอบหมาย หากต้องการมอบหมายสมาชิกในทีม ดู มอบหมายแอปเฉพาะให้สมาชิกในทีม
แอป internal จำกัดให้แคบลงได้อีก ที่ Settings → General → Access permission เลือก Required Permission แล้วเฉพาะสมาชิกในทีมที่บทบาทระดับองค์กรมีสิทธิ์นั้นเท่านั้นที่เปิดแอปได้
เปิดแอป internal หรือ private
แอป internal และ private ไม่มี URL สาธารณะให้บุ๊กมาร์กโดยตรง ให้เปิดผ่าน Stardeck:
- dashboard ของคุณ — คลิกแอปเพื่อเปิด
- Settings → Domain — แท็บ Domain ใต้ Deployments มีปุ่มที่เปิดแอปในแท็บใหม่: Visit Site เมื่อมี custom domain ที่กำหนดไว้ มิฉะนั้นเป็น Visit Default URL
ทั้งสองทางจะตรวจสอบสิทธิ์การเข้าถึงและให้คุณเข้าสู่ระบบด้วยบัญชี Stardeck แอปจะเปิดอยู่ในกรอบของ Stardeck หากต้องการให้คนที่แก้ไขแอปไม่ได้เห็นแอปเต็มหน้าต่าง (POS บน iPad หรือ dashboard บนผนัง) ให้ปิด Show app shell ใน Settings → General ส่วนคนที่แก้ไขแอปได้จะเห็นกรอบเสมอ ดู เพิ่มลงในหน้าจอโฮม
โดเมนของคุณเอง (custom domain)
คุณชี้โดเมนของคุณเอง (custom domain) ไปที่แอปที่มี visibility แบบใดก็ได้ custom domain จะใช้กฎการเข้าถึงเดียวกับแอป:
- Public + custom domain — ทุกคนบนอินเทอร์เน็ตเข้า custom domain ได้ เหมือนเดิม
- Internal + custom domain — เฉพาะสมาชิกในทีมเข้า custom domain ได้ ผู้เยี่ยมชมที่ยังไม่ได้เข้าสู่ระบบจะถูกพาผ่าน Stardeck เพื่อเข้าสู่ระบบก่อน
- Private + custom domain — เฉพาะผู้ที่เปิดแอป private ได้เท่านั้นที่เข้า custom domain ได้ ขั้นตอนเข้าสู่ระบบเหมือนกัน
เมื่อคุณตั้ง custom domain Stardeck จะใช้โดเมนนั้นเป็น URL หลักของแอปเป็นอันดับแรก การบุ๊กมาร์ก custom domain ใช้ได้ตลอดขั้นตอนเข้าสู่ระบบและการใช้แอป — แถบ URL จะอยู่ที่โดเมนแบรนด์ของคุณตลอด
custom domain ต้องตั้งค่า DNS และออกใบรับรอง TLS ของตัวเอง ดูขั้นตอนตั้งค่าที่ คู่มือ Custom Domains
สิ่งที่ผู้ใช้ปลายทางของคุณเห็น
หากคุณใช้แอป public ผู้ใช้ปลายทางจะเข้าสู่ระบบผ่านหน้าเข้าสู่ระบบของแอปที่ deploy เอง (ตั้งค่าที่ Settings → Authentication) ที่ URL สาธารณะหรือ custom domain ของคุณ ขั้นตอนนี้ไม่เปลี่ยนแปลง — visibility เป็นการตั้งค่าที่กำหนดว่าใครอื่นเข้าถึงแอปได้ ไม่ใช่วิธีที่ผู้ใช้ของแอปเข้าสู่ระบบ
หากคุณใช้แอป internal หรือ private จะไม่มีการสมัครของผู้ใช้แอป — ทุกคนที่เปิดแอปเข้าสู่ระบบ Stardeck อยู่แล้ว และแอปมองเขาเป็นผู้ใช้ Stardeck
Surfaces และ visibility ของแอป
แอปหนึ่งแอปมีได้หลาย Surface (เว็บไซต์ลูกค้า หน้าผู้ดูแล POS และอื่นๆ) แต่ละ Surface มีสถานะ public หรือ internal ของตัวเอง แต่ไม่สามารถเขียนทับ visibility ของแอปที่เข้มกว่าได้:
| Visibility ของแอป | การเข้าถึงของ Surface | ผลที่เกิดขึ้นจริง |
|---|---|---|
| Public | Public | URL ของ Surface เป็นแบบ public |
| Public | Internal | URL ของ Surface เป็นแบบ internal สมาชิกในทีมที่เข้าสู่ระบบแล้วเข้าได้ |
| Internal หรือ private | Public | ยังเป็น internal — visibility ของแอปมีผลเหนือกว่า |
| Internal หรือ private | Internal | URL ของ Surface เป็นแบบ internal |
สำหรับ URL ที่ใช้เปิด โหมด shell และคำเตือนเรื่องสิทธิ์ในแอป ดู Surface